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READ THIS FIRST 


This manual contains instructions on the installation and operation of 4.3BSD UNIX on Integrated 
Solutions, Inc. (ISI) computer systems and CPU boards. These systems and boards use the 68010 or 68020 
processors and are available in two families: 

• The Optimum series, based on the LSI- 11 bus (Q-bus). 

• The Optimum V scries, based on the VMEbus. The Optimum V series includes Diskless and Cluster 
Nodes. 

Who Should Read This Guide? 

You should read this manual if you are responsible for the installation or maintenance of your system. 
Casual users (people who log in with user accounts to do normal work) do not ordinarily need this manual. 

This manual assumes familiarity with UNIX; it is not intended for first-time UNIX users. 

What Does This Guide Cover? 

This manual explains how to get started with UNIX, including 

• Installing UNIX from tape (if necessary) 

• Starting UNIX (“booting”) 

• Optimizing UNIX for your applications 

• Adding terminals and users 

• Setting up a network 

• Troubleshooting 

A separate publication, Field Upgrade Procedure, UNIX 4.2BSD to 4.3BSD, describes the upgrade 
procedure for existing 4.2BSD systems. 

This manual contains eight sections and four appendices: 

Section 1 provides introductory material on UNIX and system administration. 

Section 2 tells how to turn on power for the system and log in. 

Section 3 describes setting up the system for normal operation. 

Section 4 tells how to alter the system for your configuration. 

Section 5 describes system network connections. 

Section 6 describes setting up and operating a cluster network. 
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Secuon 7 describes setung up and operating a diskless network. 

Secuon 8 describes day-to-day maintenance and system operation procedures. 
Appendix A tells how to install UNIX from a release tape. 

Appendix B describes some hardware diagnosuc programs. 

Appendix C is a configuration worksheet, where you can make notes on your system. 
Appendix D provides space to insert any release notes for your system. 


Some Naming Conventions for This Guide 

This is a brief glossary of references you will sec in this manual: 

ISI is Integrated Solutions, Inc. 

Optimum System is the Optimum series of ISI systems based on the LSI-11 bus (Q-bus). 

Optimum V System is the Opdmum V scries of ISI systems based on the VMEbus. 

Optimum V Workstation is the special graphics display system; largely the same as the Optimum V 
System, but with a graphics subsystem (processor board, display memory board, high-resolution 
monitor, keyboard, and mouse). 

A node is any system in a local network with its own CPU board. For example, in a cluster network, the 
server system and each cluster are nodes. 

A server node is the central node for a network of other nodes without disks of their own. For diskless 
networks, the server node can be an Optimum System, an Optimum V System, or an Optimum V 
Workstation, and must have an Ethernet controller. For cluster networks, the server node must be an 
Optimum V16 or V24 SystemAVorkStation. 

A Cluster Node is a set of boards that occupy a portion of the card cage of a V16 or V24 system. The 
cluster node may be a graphics node (Workstation), or it may be a non-graphics node (Compute Node) 
with two serial lines for terminal connections (console and Port 0). 

A Cluster Compute Node is a cluster node without a graphics subsystem. 

A Cluster Workstation is a cluster node with a graphics subsystem. 

A Diskless Node is a system with no disk of its own, connecting through an Ethernet network to a server 
node. The diskless node may be a graphics node (Workstation), or it may be a non-graphics node 
(Compute Node). 

A Diskless Compute Node is a diskless node without a graphics subsystem. 

A Diskless Workstation is a diskless node with a graphics subsystem. 

A hostname is the official system name for any node, generally assigned with admin (8). 

The word “system” applies gcnerically to any of the following: 
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• An Optimum System 

• An Optimum V System 

• An Optimum V Workstation (stand-alone) 

• An Optimum V Cluster Compute Node 

• An Optimum V Cluster Workstation (a graphics node) 

• An Optimum V Diskless Compute Node 

• An Optimum V Diskless Workstation (a graphics node) 

• The server node of a cluster or diskless network (a server node is an Optimum System, Optimum V 
System, or Optimum V Workstation) 

Throughout this manual, you will see these uses of boldface and italics: 

Boldface 

• Section headings. 

• References to UNIX commands (tar(l) refers to the command tar; the “(1)” shows that you 
can find a description of tar in "Section 1: Commands” of the UNIX 4.3BSD User s Reference 
Manual (URM)). 

• Commands that you type to UNIX exactly as printed (for example, “Enter fsck and press 
RETURN”). 

» Messages that UNIX prints on your screen (for example, login:). 

• User account names (for example, the root login account, the group operator). 

Italics 

• Names of manual (for example, the Optimum V24 System Installation Manual). 

• Names of files (for example, I etc! passed). 

• Parts of commands that you must replace with real values (for example, dev refers to a hardware 
device; you must type the actual name of the device where you see dev). 

When you see boldface and italics mixed, as in this example: 

Enter this command: 

cfev(0.0)vmunix 

this means that you should replace dev with the name of a real UNIX device, and type the rest as shown. 
For example: 

sm(0,0)vmunix 


v 
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Related Documents 

You should have these documents: 

• The UNIX 4.3BSD Reference Set, seven volumes: 

— UNIX User’ s Reference Manual (URM) 

— UNIX User’s Supplementary Documents (USD) 

— UNIX Programmer' s Reference Manual (PRM) 

— UNIX Programmer' s Supplementary Documents, Volume 1 (PS 1 ) 

— UNIX Programmer' s Supplementary Documents, Volume 2 (PS2) 

— UNIX System Manager' s Manual (SMM) 

— User Contributed Software (UCS) 

• VI Reference Card for the vi (1) editor 

If you are upgrading an existing UNIX 4.2BSD system, you should also have this document: 

• Field Upgrade Procedure, UNIX 4.2BSD to 4.3BSD 
These manuals document the Optimum V series: 

• Optimum V8 System/WorkS tation Installation Manual 

• Optimum V13/VJ6 Site Preparation and Installation Manual 

• Optimum V24 Systcm/WorkStation Installation Manual 

• VME-68K10 Hardware Reference Manual 

• VME-68K20 Hardware Reference Manual 

• VME-HSMEM Hardware Reference Manual 

• VME-HSMEM -8/4 Hardware Reference Manual 

• VME-SCSI/U Host Adapter Hardware Reference Manual 

• VME-QIC2IX Hardware Reference Manual 

• VME-TC50IX Hardware Reference Manual 

• VME-ICPJ6/8X Hardware Reference Manual 

• VME Graphics Subsystem Hardware Reference Manual 

• VME Color Graphics Subsystem Hardware Reference Manual 

There are many good introductory UNIX reference books. One such book, Introducing the UNIX System 
(McGilton and Morgan, 1983: McGraw-Hill), includes a section on system administration. 

Copies of the above-mentioned manuals and UNIX book can be ordered through your local IS I sales 
office. 
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SECTION 1: INTRODUCTION 


If you have not yet done so, please read "Read This First" at the beginning of this guide. 

This section describes the functions of a System Administrator and provides background knowledge on the 
hardware and software that you will use. 

This section contains the following subsections: 

1.1 What Does a System Administrator Do? 

1 .2 Introduction to Hardware 

1.3 Introduction to Software 

1.1 What Does a System Administrator Do? 

The UNIX operating system requires attention if it is to run well. No two UNIX installations are exactly 
alike; your system’s UNIX configuration is different from others. 

A System Administrator has four principal duties: 

• Tc install UNIX on a computer system. 

• To keep UNIX running on that system, adjusting UNIX as necessary. 

• To record changes to (and/or problems with) the system, keeping a log of activities. 

• To back up the system (save copies on tape) on a regular basis. 

These duties require familiarity with UNIX and with the hardware and software components of your 
computer system. "Related Documents" in "Read This First" suggests reading material concerning your 
Optimum or Optimum V system. It also suggests some basic texts on UNIX geared for general knowledge. 

To function as a System Administrator, you must be able to perform these tasks: 

• Log in to the system as superuser (see Section 1.3, "Introduction to Software") 

• Move easily through the UNIX file system 

• Edit files with a UNIX editor (vi(l)\ ex(l), ed (1)) 

• Follow the procedures throughout this guide 

• Maintain a system log (notebook) 

1.2 Introduction to Hardware 

As a System Administrator, you do not have to handle much hardware directly, but you do need to know 
how UNIX deals with the hardware. Figure 1-1 shows a block diagram of an Optimum or Optimum V 
system. 


Rcicrenees of the form name (X) refer to a subsection named name in Section X of the UNIX 4.33SD Reference Set. Section 1, 
6, and 7 are in the URM volume, Sections 2, 3, 4. and 5 are in the PRM volume, and Section S is in the SMM volume. See 
"Related Documents" in "Read This First". 
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Figure 1-1. Block Diagram of an Optimum or Optimum V System 

Cheek your Installation Manual if you are interested in the physical connections. For now, consider these 

components in the way that UNIX secs them: 

Central Bus (LSI-1 1 or VMEbus): The means by which other system components communicate with 
each other. The bus is a set of channels through which signals pass from board to board. The 
“backplane” is the rigid piece of hardware to which the boards physically attach; the “bus” is the 
format and design of signal arrangements on the backplane. ISI uses two different buses for two 
separate product lines: the Optimum series of systems, based on the DEC LSI-11 bus (“Q-bus”), 
and the Optimum V series, based on the VMEbus. 

CPU (central processing unit): The “brain” of the system. The CPU executes UNIX commands. 
Programmable Read-Only Memory (PROM) chips on the CPU contain a rudimentary monitor and 
loading facility for UNIX. You use these PROMs, with a limited set of commands, to bring up the 
system and to execute the larger body of UNIX from disk or tape. 

Memory: Volatile, fast-access storage for programs and data. 

Disk: A magnetic storage medium for large amounts of data. UNIX refers to each disk as a separate 
device, signified by two letters and a number (for example, “sml”). The letters describe the model 
and type . of controller board that supports the disk; the number distinguishes one disk and/or 
controller from another in the system. Each disk, in tum, holds seven or eight logical storage areas 
called “partitions,” labeled a-g[h]. Do not confuse partitions with “cylinders;” cylinders are 
physical parts of the disk, while partitions arc larger areas that include multiple cylinders. 

Tape: A removable magnetic storage medium for long-term storage or for transferring data between 
systems. UNIX refers to each tape subsystem (the tape drive and its controller) as a separate device, 
signified by two letters and a number, as with disks (for example, “tsO”). 

Terminals: A device humans use to communicate with UNIX. To UNIX, a terminal is simply a special 
kind of hie: UNIX writes to the file (things appear on your screen) and reads from the file (you type 
something on your keyboard). UNIX refers to these special files as “ttys” (for example, iryOl , 
try 02. and so forth). You must tell UNIX what kind of terminal you are using, what settings (baud 
rate and parity, for example) you have made on the terminal, and where you are plugging it into the 
system. 

Ethernet and other devices: Each is a special case. The Ethernet board allows networking to other 
systems (see Section 5.1). Other boards support terminal connections or line printers (see Section 
3.-); the Optimum V Workstation uses special boards for the graphics monitor. 
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Figure 1-2. Block Diagram of a Cluster Node Configuration 


Figure 1-2 shows a block diagram of a Cluster Node configuration. A cluster configuration consists of a 
server node that provides central disk storage and cluster nodes. The cluster nodes share a common system 
package with their associated server node. 

Cluster nodes and server nodes are physically installed in the same card cage. By adding additional boards 
to an Optimum V16 or Y24 System, you can create independent computer system-, each with its own 
memory, CPU, and peripherals, yet sharing common disk storage. 

The server and cluster nodes communicate through the VMEbus. A UNIX device “driver” supports this 
communication and is named “VB”. When you install a cluster node system, you must include this driver 
in the system configuration information. 

See "Section 6: Setting Up Cluster Nodes" for the specific UNIX features that support cluster nodes. 

Cluster Nodes are similar to Diskless Nodes. The difference is that cluster nodes are contained within a 
single card cage and communicate via a “shared memory” (VME-CMEM), whereas diskless nodes are 
independent physical units that communicate via an Ethernet network. Figure 1-5 shows a block diagram 
of a Diskless Node configuration. 
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Figure 1-3. Block Diagram of a Diskless Node Configuration 

The diskless node also uses a server node for disk storage. System administration tasks for cluster nodes 
and diskless nodes are almost identical. 

Any system that uses an ISI Ethernet board (VME-ECX) or Excelan Ethernet board (VME-EC or 1SEC) 
can connect to a network. Any Optimum V (VMEbus-based) system that is on the network and has a disk 
can act as a server node for diskless nodes. Several server nodes can co-exist on a network; each server 
node can support one or more diskless nodes. 

See "Section 7: Setting Up Diskless Nodes" for the specific UNIX features that support diskless nodes. 

1.3 Introduction to Software 

You should be familiar with the UNIX hierarchical file structure. A file’s full name pinpoints its location 
in that structure. For example, the filename lusr! lib! aliases defines a file ‘''aliases’ ’ in a director,’ "lib,” 
which in turn is an entry in the director' " usr ,” and "usr” stems from the “root” director’ (sicnified bv 

hier (7) shows the skeletal structure of the UNIX file system. Cluster and diskless networks rely on the 
Transparent Remote File System (TRFS) to share a single file system among several nodes on the network. 
TRFS is an ISI utility that allows access to files on other nodes through a user-transparent set of network 
protocols. 

If you are confused by directories and filenames, see "Read Tnis First" for introductory documents on 
UNIX. 

An important file in the root directory, Ivmunix, contains the “kernel” for the UNIX system. The kernel 
determines device configurations and other important system parameters. Section 4.2, "Configuring the 
Kernel", provides instructions on tailoring the kernel to your particular system. 
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The UNIX operating system, as shipped by ISI, consists of five major parts: 

• A “minirool” file system, used only when loading UNIX from a release tape. 

• The root (“/”) file system. 

• The lusr file system. 

• Optional graphics files. 

• Stand-alone diagnostic programs, on a separate tape. 

To install or make changes to these and other system files, and to perform many of the system administrator 
functions such as adding new users to the system, you must have unlimited access to the entire system. 
You do this by logging in to the system as root and giving the appropriate password. You set the root 
password as part of the first-lime installation procedure. (Sec "Section 2: Starting UNIX From Disk" or 
"Appendix A: Starling UNIX From Tape".) 

When you log in as root, you are now a superuser. This means that you have undeniable access to 
everything on the system. If you make an error (such as using the rm (1) command while you are in the 
wrong directory) you can destroy the file system, in which case you will have to re-install the UNIX 
software from the release tape. While superuser, you must be careful to protect system files and/or files 
containing work done by others. There arc three ways to protect both yourself and others: 

• Follow procedures in this guide exactly. 

• If you have any doubt, copy files onto tape before making changes. Use the tar(l) or dump (8) 
commands to copy files onto tape where they will be safe. 

• Keep a complete log of everything you do in a notebook near the console. 
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SECTION 2: STARTING UNIX FROM DISK 


This section describes system startup and how to log in to UNIX. Your Installation Manual contains some 
of this information; this section offers more detailed instructions on troubleshooting. 

When you first use an Optimum or Optimum V system, you do not need to install UNIX. The disks 
shipped from Integrated Solutions contain everything necessary for UNIX to autoboot (begin operation 
automatically). 

If you do not have disks shipped from Integrated Solutions, or if you want to install UNIX from a release 
tape for any other reason, turn to "Appendix A; Loading UNIX From Tape." 

Use die procedures in this section to boot server nodes for cluster or diskless networks. Sec "Section 6: 
Setting Up Cluster Nodes" or "Section 7; Setting Up Diskless Nodes" to bool oilier nodes on the network. 

This section contains the following subsections: 

2.1 What Is “Bootstrapping?” 

2.2 Do You Have Everything You Need? 

2.3 Booting the System 

2.4 Shutting Down the System 

2.5 How Does the Autoboot Work? 

2.6 What to Do if the Autoboot Fails 

2.1 What Is “Bootstrapping?” 

“Bootstrapping,” usually abbreviated to “booting,” means loading and starting the operating system (or 
other program). UNIX does as much of the work as possible, essentially pulling itself up by its own 
bootstraps. This feature, booting without the help of humans, is “autobooting.” 

Your role in autobooting UNIX should be simple: 

• Turn on power 

• Give the current date and time 

• Log in as superuser 


2.2 Do You Have Everything You Need? 

You must have a fully installed system, as described in the appropriate Installation Manual. For cluster or 
diskless networks you must have a fully installed and configured server node. 

Tne boot procedure in Section 2.3 assumes that you have a disk ready for UNIX autobool. If the disk does 
not contain the proper files, UNIX will not autobooL In this case, refer to Section 2.6, "What to Do if the 
Autoboot Fails." 

You must know the name of your system’s boot disk; you will need to use this name in commands you 
enter. Use Table 2-1 to find the disk's name. Enter this disk name on the configuration worksheet in 
Appendix C. 
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Table 2-1. UNIX Disk Names 


Disk Name | Device 

Controller Name 

Optimum V Systems and Workstations 

VDS106 

VED106 

5 Vi-inch disks (SD-style) 
106 Mbyte formatted 

sd 

VDS269 

VED269 

8-inch disks (SMD-style), 
269 Mbyte formatted 

sm 

VDS418 

VED418 

9-inch disks (SMD-style), 
418 Mbyte formatted 

sm 

VDS494 

VED494 

8-inch disks (SMD-style), 
494 Mbyte formatted 

sm 

Optimum Systems 

DS36 

ED36 

5 ’/ 4 -inch disks, 

36 Mbyte formatted 

cl 

DS67 

ED67 

5 '/4-inch disks, 

67 Mbyte formatted 

cl 

DS85 

ED85 

5 i/4-inch disks, 

85 Mbyte unformatted 

cl 

DS140 

ED140 

5 '/4-inch disks, 

140 Mbyte unformatted 

cl 

DS330 

ED330 

SMD-style disks, 

330 Mbyte formatted 

hp 

DS418 

ED418 

SMD-style disks, 

418 Mbyte formatted 

hp 

DS474 

ED474 

SMD-style disks, 

474 Mbyte unformatted 

hp 


You should also have these materials on hand: 

• The appropriate Installation Manual (for example, the Optimum VS System/WorkStation Installation 
Manual) 

• The UNIX 4.3BSD Reference Set, seven volumes 
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2.3 Booting the System 

If you encounter trouble during this boot procedure, refer to Section 2.6, "What to Do if the Autoboot 
Fails." 

For details of what happens in the following procedure, see Section 2.5, "How Does the Autoboot Work?" 
The following procedure, the UNIX Autoboot Procedure, describes the steps you take to autoboot UNIX. 


UNIX Autoboot Procedure 



ACTION 

WHAT IT DOES 

Step 7. 

Turn ON power for the terminal (or 
Workstation monitor) connected as 
your system console. 

Prepares the terminal to print boot messages. 

Step 2. 

Turn ON system power. Sec die 
appropriate Installation Manual for 
detailed power-up instructions. 

Check that the DC ok indicator 
lights up. 

Provides power to die system and begins die 
autobool. The console should show the message 

Initialize all memory . . 

(Opumum V Workstations do not display this 
message.) 


After a short wail (about ten seconds), this message 
should appear on the console: 

Integrated Solutions 

VMEBUS((2i>£/S) 680.Y.Y prom-lcvel boot '.date 


Step 3. If you have booted UNIX 
previously, and you know the root 
password, go on to Step 4 of this 
procedure. 

If this is the first time for booting 
UNIX on this machine, you must 
boot UNIX single-user and assign a 
password to the root (“superuser”) 
account. Enter 

ctev(0.0)vmunL\ 

where dev is the 2-letter name for 
your boot disk, from Table 2-1. 

Follow the further instructions in 
the column at right. 


The colon (:) is a prompt from the UNIX PROMs 

(see Section 1.2\ 

Boots UNIX in single-user mode. 

The console now displays informauon about 
available devices and file systems, beginning with 

Integrated Solutions UNIX Release 4.0 £/: 
(root(ci'system-namc) date 
real mem= (physical memory) 
avail mem= ( memory available for user programs) 
Using xx buffers containing . . . 

and ending with a single-user UNIX prompt (fX 
To set the root password, use the command 

passwd root 

and follow the instructions of the command prompts. 
After setting the root password, enter the command 
reboot 

and resume this procedure with the next step. 


(continued on next page) 
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UNIX Autoboot Procedure (continued) 


ACTION 

Step 4. You have assigned, or already 
know, the root password for this 
system. The screen shows the 
message 

Integrated Solutions 
VMEBUSfCBUS; 680XX 
prom-levcl boot: date 

Enter the character (SHIFT-2 
on most terminals) and press 
RETURN. 


WHAT IT DOES 

Tells the PROMs to continue the autoboot. Entering 
any other character interrupts the autoboot. After 1 5 
seconds, the autoboot continues anyway, with this 
message: 

: AUTOBOOT: <fcv(0,0)vmunix 

where dev is the name of the system’s boot disk (see 
Table 2-1). 

The console now displays information about 
available devices and file systems, beginning with 

Integrated Solutions UNIX Release 4.0 #/t 
(root @syslcm-namc) date 
real mem= (physical memory) 
avail mem= (memory available for user programs) 
Using xx buffers containing . . . 


and ending with 
You have 60 second(s) to enter date/lime: 


Step 5. 

Enter the current date and time, in 
this format: 

yymmddhhmm 

For example, to enter April 15, 
1987, at 2:30 p.m., enicr 

8704151430 

Tells UNIX what date and time it is. See date(l) 
for details on the entry format. After one minute 
without an entry', UNIX assumes the last known date 
and time, and continues the autoboot. 

After displaying several more messages and checking 
file system consistency, the console shows this 
prompt: 


and press RETURN. 

Integrated Solutions UNIX 

(system-name) (terminal line) date 

login: 



This is the UNIX login prompt. UNIX is now 
running in multi-user mode. 

Step 6. 

Log in as the superuser by entering 
root as your login name. You 
assigned the root password while in 
single-user mode ('see. Step 3 of this 
procedure). 

Logs in to UNIX, giving access to a working C shell 
(UNIX command processor). You can now issue 
UNIX commands to the shell prompt. This is the 
UNIX multiuser prompt: 


svstem-name-r 


where system-name is originally “UNKNOWN”. 

You will assign the system name in a later procedure. 

End of procedure 


.After a successful boot, you are ready to set up your system for normal multiuser UNIX operation. Turn to 
''Section 3: Setting Up Your System." If you are changing your hardware configuration, and need to adjust 
UNIX for the new hardware, see "Section 4: Configuring Your System." 
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2.4 Shutting Down the System 


CAUTION 

Failure to shut down the system in an orderly fashion may result in lost 
data. In particular, if you simply turn off power without an orderly 
shutdown you will possibly lose data. 

If you are running multiuser UNIX, use the command shutdown (8) in the following procedure. If you are 
running single-user UNIX (the console shows the single-user prompt (#)), skip to Step 2 of the following 
procedure. 

If your machine is a server for cluster or diskless network nodes, shut down the individual cluster or 
diskless nodes with the procedures in "Section 6: Selling Up Cluster Nodes" or in "Section 7: Setting Up 
Diskless Nodes." After shutting down any nodes that use this server, use the following UNIX Shutdown 
Procedure for the server node. 

Use die UNIX Shutdown Procedure outlined below to shut down the system. 

NOTE 

You must be logged in as superuser (root) at the system console before 
you can run this procedure. 


UNIX Shutdown Procedure 



ACTION 

WHAT IT DOES 

Step 7. 

Enter this command at the system 
console: 

shutdown +/i 

where n is a time in minutes. 

Notifies users of shutdown, waits for the specified 
time, and then kills all processes. When shutdown is 
complete, the console shows the sinde-user prompt 
(*)• 

CAUTION 

If you turn off your system at this point, veu risk 
losing data. You must finish all steps of this 
procedure. 

Step 2. 

Enter these commands: 
cd / 

synctsync 
umount -a 
reboot 

Unmounts the file systems and updates the 
superblock. This protects the disks from accidental 
erasure when power goes off. 

Wait until the PROM prompt (:) appears. 

Step 3. 

Turn OFF system power. See the 
appropriate Installation Manual for 
specific power-down instructions. 

Removes power from the system. Tne system is now 
off. 

Step 2. 

If the system will be off for some 
time, turn OFF power to connected 
devices, such as the system 
console. 

Conserves power. 


End of procedure 


do 


20 
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2.5 How Does the Autoboot Work? 

Suggested reading: 

• “Fsck — The UNIX File System Check Program,” UNIX 4.3BSD System Manager' s Manual (SMM:5) 
. fsck (8) 

• init (8) 

• rc(8) 

• reboot (8) 

UNIX will try to autoboot under several conditions: 

• Turning on system power (sec Section 2.3, "Booting the System") 

• Recovering from a system crash 

• Receiving a reboot (8) command from the superuser 

• Receiving a fastboot (8) command from the superuser 

All of these, in one way or another, involve the rc (8) command file, a set of instructions that UNIX uses in 
booting. As superuser, you can control the speed and caution of the boot process, ranging from a slow and 
careful boot to a fast boot that ignores possible damage to data on the disks. 

Figure 2-1 shows a sample of a normal boot. This example uses an Optimum V8 System with Release 4.0 
software and a YDS 106 disk subsystem. 
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Initialize all memory . . 

(Integrated Solutions logo appears here) 

Integrated Solutions 

VMEBUS 68020 4.4/1 boot: Wed Apr 22 19:15:44 PDT 1987 
: AUTOBOOT: sd(0,0)vmunix 

Integrated Solutions UNIX Release 4.0 #1 (root@UNKNOWN) Wed Apr 1 16:58:26 PST 1987 

real memory = 2.25M 

available memory = 1.1 1M 

using 90 buffers containing 0.23M of memory 

SDO at address OxffffeO/077777740 vector 0x78/0170 level 6 
sdO at SDO slave 0 78.36M (25 x 7 x 917) 

a: 15884 b:33400 c :abdcfg: 160475 d: 15884 

c: 55936 f: 38850 g:dcf: 110775 

TS0 at address Oxf f f550/077772520 vector 0x94/0224 

tsO at TS0 slave 0 1/4" QIC2 tape drive 

EX0 at address Oxf f 0000/077600000 vector 0x40/0100 

exO at EXO slave 0 (08:00: 14:20:02:72) HV 0.0 

root on sdOa, dump on sdOb, args on sdOb, swap on sdOb 

16.67MHz MC6S020 CPU 
CTC system clock 
sdO: 1 1 remapped sectors 

*** WARNING: Should run interleaved swap with >= 2Mb *** 

Automatic boot in progress... 

Wed Apr 22 19:19:02 PDT 1987 

You have 60 second(s) to enter date/time: 8704230935 

Thu Apr 23 09:35:00 PDT 1987 

/dev/sdOa: 261 files, 4116 used, 3305 free (73 frags, 404 blocks, 0.3% fragmentation) 

/dev/sdOg: 3113 files, 30063 used, 12544 free (132 frags, 3103 blocks, 0.3% fragmentation) 

Thu Apr 23 09:36:33 PDT 1987 
check quotas: done, 
starting system logger. 

stare ng local daemons: bootd routed named timed sendmail. 
preserving editor files 
clearing /imp 

standard daemons: update cron accounting, 
staring network daemons: inetd rwhod printer. 

Thu Apr 23 09:36:58 PDT 1987 

Integrated Solutions UNIX (UNKNOWN) (console) Tnu Apr 23 09:37:03 PDT 19S7 
login: 


Figure 2-1. Sample of a Normal Autoboot 
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Autobooting follows the steps in Table 2-2. 


Table 2-2. How the Autoboot Works 


WHAT UNIX DOES 

SEE. . . 

The PROMs initialize all memory; this clears the computer memory in 
preparation for loading a program (for example, UNIX) from disk or 
tape. 


The PROMs load UNIX into memory and begin execution. This 
executes the kernel (/ vmunix ) and begins a consistency check of the file 
systems. The console shows the known devices and their current 
configurations. 

In Figure 2-1 , UNIX finds one disk sdO and one tape drive tsO. sdO has 
seven partitions, lettered a-g. Note that partition c actually refers to the 
entire disk, while partition g refers to partitions d, e, and / combined. 
In practice, you ordinarily deal only with partitions a, b, and g. 

reboot (8) 

UNIX prints some messages about system hardware. In Figure 2-1, 
these messages 

• Identify the CPU 

• Show parity status 

• Identify the system clock 

• Warn you to set up two swap devices (ignore this message) 


UNIX executes the letclrc command file. 
| re begins by printing the message 
j Automatic boot in progress... 
j on the console. 

rc(8) 

| re prompts for the current date and time. After one minute with no 
entry, UNIX assumes the last known date and time. 

At this prompt, you can safely exit the rc script by entering two 'C‘s 
(CTRL-C twice). 

date (1) 

(continued on next vacs) ! 
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Table 2-2. How the Autoboot Works (continued) 


WHAT UNIX DOES 

SEE . . . 

re runs the file system check procedure, letclfsck -p. This prints 
diagnostic messages on the console, then gives one of five results: 

fsck (8) 

• Normal completion; rc prints the date and time and continues with 
the autoboot. 

• Restart; rc decides to reboot again from the beginning. This 
happens when fsck fixed problems in the root (/) file system. 

• Automatic reboot failed... help! fsck encountered bad disk areas, 


and needs your help in proceeding. Section 2.6, "What to Do if the 
Autoboot Fails," covers this case. 


• Reboot interrupted means that something caused fsck to slop 


before finishing. This could happen if you sent an interrupt signal 
CC) from the console. You should restart the boot with reboot (8), 
as described in Section 2.6. 


• Unknown error in reboot means just what it says. You should run 


fsck manually, as described in Section 2.6. 


rc calls the commands swapon and mount to set up the disks and file 

swapon (8) 

systems for availability. Both of these commands rely on the file 

mount (8) 

/etclfstab for information on disk allocation. These calls should not 
generate any messages on the console. 

fstab (5) 

rc runs quotacheck (8) to see that the current file systems have not 

i 

quotacheck (8) j 

overrun their allowed sizes (see Section 8.6, "Accounting"). This 
generates a console message when the quota check is finished. 

quotaon (8) 

! rc then runs quotaon (8) to turn on quotas for all file systems in 
ietcifsiab that show quotas, quotaon should not print anything on the 
console unless you have set quotas in some file system; the ISI UNIX 
! release has quotas turned off. 

i 

j 

I 

j 

1 

| rc executes the command file letc/rc. local. This file contains 

rc (S) | 

commands that you use to customize UNIX to your site. Tne rc. local 
j file on your release tape and disk performs these functions: 

hostname (I) 

i • sets your system hostname to UNKNOWN. See Section 3.3. 
; "Initializing Your System,” to change this. 

daemons: 
syslogd(S) j 

routed (SC) 

I • builds a “message of the day” in ietc/moid to print for users when 

named (SC) ! 

they log in. You can edit ietc/tnotd to say whatever you want; j 

timed (S) 

rc. local simply ensures that the first line of ietc'motd describes the 

sendmail (S) ' 

current UNIX version. 

1 

! 

• starts up a sc: of daemons (processes that run in the background). j 

graphics: 

fontd(S') 


(continued on next pose) 
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Table 2-2. How the Autoboot Works (continued) 


WHAT UNIX DOES 

SEE . . . 

rc clears the temporary file area, limp, after saving any limp files 
dealing with editors. The editors (vi, ex, and ed) use limp to store 
scratch copies of files being edited, and can use these scratch files to 
reconstruct lost files if the editor or the system crashes. 

ex(l) 

rc starts up a set of standard daemons. 

One of these daemons, inctd (8), starts up additional daemons. The file 
letc/inctdxonf defines these additional network daemons. 

update (8) 
cron (8) 
accton (8) 
rv hod (8) 
Ipd (8) 
inetd (8) 

rc finishes, and UNIX prints the current lime. UNIX now prompts for 
login. 



2.6 What to Do if the Autoboot Fails 

Read this section if the procedure in Section 2.3, "Booting the System" did not reach a login prompt. For 
difficulties after the login prompt, after you have logged in as root, see "Section 3: Setting Up Your 
System." 

If the boot failed, find the appropriate symptom in Table 2-3. 

Some difficulties in booting a graphics workstation may be related to graphics hardware. See the 
appropriate Installation Manual for your workstation for instructions on connecting a regular ASCII 
terminal to the workstation for diagnostic purposes. You can then boot UNIX using the ASCII terminal. 


2-10 


Startinc UNIX From Disk 


2-10 




System Administrator Guide 


SMM: 1 


Table 2-3. Symptoms of Boot Failure 


SYMPTOM 

SOLUTION 

The terminal docs not respond to 
any typed commands. Pressing *C 
(holding down the CTRL key and 
pressing “c”) gets no response. 

Check the Run and DMA lights on the front panel of your 
system. If these lights are flickering, the system is in the 
middle of some process. Wail for it to finish. (The file 
system check can take several minutes to complete.) If it 
does not finish in several minutes, press the RESET 
button; this will restart the boot process. 


CAUTION 


Pressing RESET while the DMA light is 
flickering may result in data loss. 


You arc using the wrong RS232C cable for this terminal. 
The console port, the ‘‘Port 0” line, and other serial ports 
use ‘‘straight through” cables on non-graphic systems. 
You might have a ‘‘twisted” or ‘‘null-modem” cable, 
which would cause the terminal not to work. 


Expansion ports (DZ or DH breakouts) on Optimum (Q- 
bus) systems require “twisted” cables. 


Check the original Installation Manual sent with your 
system if you have any question as to what type of 
connector or cable is used. See Section 3.4, "Setting Up 
Terminals, Modems, and Printers," for a description of 
cables. Graphic systems use cables supplied with the | 
graphic terminal. 


The terminal is not working properly. Check the baud rate 
(see ihe. Installation Manual for terminal baud rates). Turn 
the terminal off, wait a few seconds, then turn the terminal 
on again. Press RETURN. 

i 

l 

If this does not work, and you have another terminal, swap j 
terminals or swap lines to the other terminal. If you are 1 
booting a workstation, try using an ASCII terminal as 
described in your Installation Manual. 

! Finally, check the instruction manual for the terminal, j 
j Many terminals have kev seauences for “kevboard locks” ! 


I and other crippling commands. j 

; A physical connection is loose somewhere. In this order, j 
i check the following: | 

i • Connections between the terminal and the svstem. ; 

; ' i 

• Boards are correctlv seated in the card cane. 

I ' “| 

; » Connections on all cables inside the system. j 

(continued on next page) j 
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Table 2-3. Symptoms of Boot Failure (continued) 


SYMPTOM 


The boot stopped before reaching a 
login prompt, and the console now 
shows the PROM prompt (:). 


| The boot stopped before reaching a 
! login prompt, and the console now 
{ shows the single-user UNIX 
! prompt (~). 


SOLUTION 


Enter the character (SHIFT-2 on most terminals) 

and press RETURN. This may restart the autoboot. 

If does not work, restart the autoboot manually by 
entering 

dev(0,0)vmunix 

where dev is the name of the boot disk (see Table 2-1). 
vmunix is the file /vmunix, the default UNIX kernel. You 
can use any other file name, if that file is a bootable kernel. 


If dev(0,0) vmunix returns a message like 

unknown device, legal devices are: 

(list of device names) 

check that you are using the proper name for the boot 
device. 


The message 
file "vmunix" not found 

means that the disk docs not contain die file necessary for 
autobooting. You must boot off an alternate kernel. 

You might try 

dev(0,0)vmunix.C 

where C would be Q10, V10, or V20. depending on your 
system. Other possible kernel names are 

dev(0,0)vmunix.new 

dev(0,0)vmunix.old 

fl’ev(0.0)vmunix.orig 

If you cannot find a bootable kernel, install UNIX from a 
release tape. Turn to ’’Appendix A: Loading UNIX From 
Tape." 


Enter reboot and press RETURN. This should restart the 
autoboot. reboot (8) syncs the disk (updates the disk with 
any recent changes) and brings the system back to the 
PROMs for autoboot. When you see the PROM prompt 
(:). follow the boot procedure in Section 2.3. 
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Table 2-3. Symptoms of Boot Failure (continued) 


SYMPTOM 

SOLUTION 

The message 

WARNING: should run 
interleaved swap with >= 2 Mb 

appears on the console, followed 
by the single-user UNIX prompt 
(#)• 

Ignore the warning message. Treat this symptom as the 
symptom above, using the reboot (8) command. 

If you have more than one disk, you should consider 
setting up a swap area on the second disk. See Section 
4.3.2, "Optimizing Disk Efficiency." 

A message similar to 

parity error or power fail 

appears on the console, and the 
boot slops. 

This usually means that a power surge or drop interrupted 
the boot. Do nothing; UNIX will reboot automatically. 

If UNIX does not reboot automatically, use 

^ev(0,0)vmunix 

at the prompt, or 

reboot 

at the prompt. 

The message 
Reboot interrupted 

appears on the console, followed 
by the sinele-user UNIX prompt 
(*)• 

This means that something caused fsck(S), the automatic 
file system check program, to stop before finishing. This 
could happen if UNIX receives an interrupt signal ( A C) 
from the console. Restart the autoboot with reboot (8). 

The message 

Unknown error in reboot 

appears on the console, followed 
by the sinule-user UNIX prompt 

i (#). 

fsck(8) encountered something it could not deal with and 
could not even identify. Run fsck manually; see the next 
symptom. 

1 

j The message j 

Automatic reboot failed... help! 

appears on the console, followed 
by the sinde-user UNIX prompt j 

" ; 

j 

J 

i 

j 

i 

j 

fsckfS) encountered disk errors that it could not correct 
automatically. Run fsck manually. 

CAUTION 

You are now on dangerous ground; you j 

could destroy data on the disk. Read the 
rest of this section carefully before doing j 

anything else. I 

At the single-user UNIX prompt (#) enter fsck. fsck now ! 
asks for decisions on cleaning up the disk. These i 
decisions always require a yes or no answer (enter y or n j 
and uress RETURN). 


(continued on next voce) 
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Table 2-3. Symptoms of Boot Failure (continued) 

SYMPTOM 

SOLUTION 

1 

i 

1 

1 

i 

| 

I 

i 

I 

i i 

i 

! i 

! ! 

j 

j 

j 

fsck’s prompts are largely self-explanatory, fsck describes 
the file system under question, and tells what it thinks is 
wrong. It then asks for a decision. These decisions take 
two basic forms (the actual wording varies, but you can 
recognize the form): 

. SALVAGE (RECONNECT, ADJUST, FIX, CLEAR) 
actions — these correct errors in indexing and pointers 
and such, things that you ordinarily do not see. 
Answer “yes” (y) to these questions. 

• REMOVE actions — these arc the dangerous ones that 
remove data from the disk. Answer “no” (n) to these 
questions. 

After running fsck, the console shows a single-user UNIX 
prompt (#). Enter reboot and press return. 

Follow the autoboot procedure until it comes to fsck again 
(right after the date/time: prompt), fsck should then run 
without errors and the boot will continue. In this case, you 
can return to the normal autoboot procedure in Section 2.3. 

If fsck prints more errors, again run fsck manually. Enter 
fsck at the single-user UNIX prompt (#) and press 
RETURN. 

The goal is to remove as little data as possible from the 
disk. Follow this procedure: 

1. Answer yes to all SALVAGE-form questions. 

2. Answer yes to REMOVE-form questions at your i 
discretion. Be careful; you can destroy data with 
these commands. It is usually safe to remove files 
and directories for which you know you have 
replacements on tape; you can fix these later by 
installing from tape. 

i 

3. Restan the autoboot with reboot (8). ! 

j 

4. If the autoboot does not finish normally, run fsck j 

again with this same procedure. ! 

Eventually, fsck should allow the boot to finish. Return to j 
the autoboot procedure in Section 2.3. ! 
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SECTION 3: SETTING UP YOUR SYSTEM 


This section tells hew to set up the UNIX system for normal access and use. 

You should already have completed the procedures in 

• "Section 2: Starting UNIX From Disk" 
or 

• "Appendix A: Loading UNIX From Tape" 

This means that you can now log in to the system as root, and that you have complete / and lusr file 
systems mounted and ready. Check this by entering the df(l) command at the UNIX prompt (#). df 
should show both file systems and any other file systems on the disk(s). The capacity column should show 
all file systems partially filled (that is, greater than 0%). 

This section contains the following subsections: 

3.1 What Needs Setting Up? 

3.2 Using admin (8) 

3.3 Initializing Your System 

3.4 Setting Up Terminals, Modems, and Printers 

3.5 Setting Up User Accounts 

3.6 Setting Up a Mail System 

3.7 Setting Up Uucp 

3.8 Backing Up for Safety 


3.1 What Needs Setting Up? 

When using a system shipped from Integrated Solutions, many of the following setup procedures are 
unnecessary. Follow the procedures anyway; you may want to change the existing setups. For example, 
you may want to add new user accounts or redefine the terminal connections. 

If you have installed the UNIX system from a release tape, follow the procedures in this section to 
complete UNIX installation. 


Use the procedures in this section to S; 
Setting Up Cluster Nodes" or "Sectior 
complete networks. 


up the sewer node of a cluster or diskless network. See "Section 6: 
Setting Up Diskless Nodes" for procedures to finish setting up the 


mese procedures tailor the system to your site's application. Use these procedures to 
• give the system a name (hostname) 


• define network administration parameters (local, distributed (TCP/IP), or NFS (Y?)) 

• set up communication lines (terminals, modems, and printers) 

• set up user accounts (logins) 


• prepare user utilities (mail, uucp'' 
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Before continuing, turn to "Appendix C: Configuration Worksheet" and fill it out as best you can. The 
procedures that follow will use this information. 

When you set up your UNIX system, you will use an editor to modify files and add information. A display 
editor such as vi depends on having a terminal definition for it to operate properly. 

If an editor does not give the expected display (for example, vi(l) runs in “open mode”), set the 
environmental variable TERM to match the terminal that you are using. Enter 

setenv TERM termtype 

where termtype is the termcap (5) name for the terminal. If you arc using sh (1) rather than esh (1), use 
TERM=tcrmt}pe; export TERM 

to set the TERM variable in the Bourne shell. See Section 3.4.1, "Defining Terminal Lines." 


3.2 Using admin (8) 

The admin (8) program provides automatic tools for many system administration tasks. You should use 
admin when possible, due to the complexity of many administration details. If you want to understand the 
UNIX system better, the procedures in this Guide supply information on the workings of admin so that you 
can see what is happening when admin executes. 

The admin (8) program can help with these tasks: 

• Initializing your system, setting up administrative conditions 

• Adding or removing user accounts 

• S suing up a network 

• Setting up uucp 

• Installing or maintaining a printer 

• Installing cluster nodes 

• Installing diskless nodes 

CAUTION 

Execute admin (8) while in single-user UNIX mode, with iusr 
mounted. Some admin functions can cause problems while in 
multiuser UNIX mode. For a cluster or diskless network, use admin 
only on the server node. 

The following procedure tells you how to invoke the admin (S) administration program. 




Setting Ur Your System 



System Administrator Guide 


SMM: 1 


Step 1. 


Step 2. 


Step 3. 


Procedure to Use admin (8) 

ACTION WHAT IT DOES 


Boot UNIX to single-user mode. 


Enter the command 
mount 

and check that the lusr file system 
is mounted. 


Enter the command 
/etc/admin <-/;> 

The -h option runs admin in 
“hardcopy” mode, admin will 
avoid reprinting menus, printing 
only the appropriate prompt when a 
selection is necessary. Use this 
option if the console is a hardcopy 
or teletype device. 


Brings the system to a safe condition for admin 
operations. See Section 8.3, "When Do You Boot 
Single-User?" to move between UNIX modes. 

Booting to single-user mode is a precaution, to 
safeguard against interference from other users 

during admin functions. 

Checks that the lusr file system is mounted. If lusr is 
not present, you must mount it with the mount (8) 
command: 

mount lde\l devpart / usr 

where devpart is the disk partition holding lusr. Do 
not forget the /dev/ before devpart. 

For example, to mount die lusr file system on the g 
partition of the second 269-Mbyte disk (VED269) of 
an Optimum V24 system, enter 

mount /dev/smlg / usr 

Invokes the admin (8) program. 

The first time that you run admin you will run 
through an initialization procedure (see Section 3.3.4, 
"Initializing With admin (8)"). You must complete 
this initialization sequence before using admin. 

Before admin offers its menu of administration 
procedures, it checks some administrative 
parameters, admin checks for these valid data: 

• hostname in letc/rc.local 


• password administration mode (local, TCP/IP, or 
Yellow Pages) 

• various network-related files are present 


See Section 3.3, "Initializing Your System", 
funner information on these parameters. 


End of pr C ce dure 


for 
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The admin administration program prints this menu: 

ADMIN TOP LEVEL MENU 

(A) Display/modify admin parameters 

(B) User account maintenance 

(C) Diskless/cluster installation and deletion 

(?) Help 

(Q or X)Exit from admin 

Please enter letter for desired function: 


Enter your choice by letter, with no carriage return. The subsequent menus and prompts ask you for 
specific information; in most cases, the prompts arc self-explanatory. 


3.3 Initializing Your System 

The admin (8) program sets up many operating parameters for you the first time that you run it. Before 
running admin, have ready this information, as described in the following paragraphs: 

• a hostname (system name) 

• an internet network address 


• a password administration mode (local, TCP/IP, or YP) 


2.3.1 Choosing a Hostname 


The original ISI UNIX release software does not define the system name. 

Tne term “hostname” refers to the name of the system, as set by admin (8). The term “node” refers to 
any system, workstation, cluster node, or diskless node on a network. 

Choose a hostname for your system (node). Tne hostname must be unique within your intended local 
network. Use a hostname that is less than twelve ; caracters long. Do not use spaces within hostnames; 
instead, use underscores to separate words, as in v24_name. 


You will provide this nostnam 
example, if you configure a new 


to admin prompts. You might also use this hostname elsewhere; for 
:erne! for the system (see "Section 4: Configuring Your System"). 


2.3.2 Choosing a Network Address 


Choose an internet a ddr 
network (this is a “gatew 

Tne file ie:c ! hosts derm 
addresses. Network addr 


:ss for your system (node). If you will connect your node to more than one 
:\ ” node), you must choose a different internet address for each network. 

s internet addresses and hostnames; look in this file for examples of internet 
sscs nave inis iOrmai! 


K.K.n.n 

where each n is a decimal number 1-255. 

Tne first of the four numbers in an internet aduress is the "network number". If you have r local cluster 
network, for example, this number must be the same for all cluster nodes within a single card cage. A 
gateway node, connecting to more than one network, must use a different network number for each 
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network. 

As an example, if you are setting up a cluster network of three machines, you might choose the following 
internet addresses: 

1. 0.0.1 

1. 0.0.2 

1.0. 0.3 

If you want to connect the server node of this cluster network to a diskless network (a local Ethernet 
network), you would give a different network number to the diskless network: 

2.0. 0. 1 

2.0.0.2 

2.0.0.3 

This will work for installations where there is no connection to a public network such as ARPANET or 
USENET. If your nodes will be hosts on a public network, you must register with the public network 
administrator to make certain that you do not choose a conflicting internet address. Contact the 
administrator for your ARPANET or USENET news feed node. 

Enter the hostname and internet address in "Appendix C: Configuration Worksheet" under “System 
name.” If you are setting up the server node of a cluster or diskless network, also write the hostname and 
internet address in the “Networks” section of the Configuration Worksheet. You will be configuring only 
the server node at this time; to configure the cluster nodes, use the procedures in "Section 6: Setting Up 
Cluster Nodes." 

3.3.3 Choosing a Password Administration Mode 

Decide on the password administration mode for your node, from among these three choices: 

1. Local: this is an isolated node that does not depend upon any other network host for administrative 
control or maintenance. Changes to letc/passwd have only local effects. 

2. TCP/IP: this node may come under administrative control from another node on the network, 
admin will try to keep user identifications unique among an identified set of nodes. Modifying files 
on this node may affect other nodes on the network. 

3. YP: this node is pan of an NFS (Network File System) Yellow Pages network. Administrative 
changes may affect all nodes sharing the same YP server. 

If you are installing the node in an existing network environment, the choice should be predetermined by 
the other nodes on the network. If you are installing in a fresh environment, give some thought to your 
long-range network configuration plans. 

In the case of TCP/IP or YP administration, you must have ready this information: 

• a list of the other nodes (hostnames and internet addresses) participating in this common 
administration. 

• the name and address of the central password administration node on this network. 
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3.3.4 Initializing With admin (8) 

You are now ready to use admin (8) to initialize your system. See Section 3.2, "Using admin (8),’’ and 
execute the admin program. 

admin now prompts you for information. You will only have to enter this information once, the first time 
you run admin. You can change this information later, using the “Display/Modify admin parameters” 
menu choice in admin. 

System initialization follows the steps in Table 3-1. admin does not actually change system files until you 
have completed the entire procedure; if you quit admin before performing all steps, die system will return 
to its previous state. When Table 3-1 refers to affected files, remember that admin docs not actually write 
the modifications until die procedure is complete. 


Table 3-1. admin System Initialization 


What admin (8) Docs 

Affected Files 

Prints the message 

— 

First-time admin initialization 


This initialization occurs the first time you run admin. You must 


complete this initialization sequence before using other admin 


procedures. 


If admin prints the message 


— Can’t locate filename — 


i this means that the admin temporary file area 


| lusr tlibl adminllo cal- data 


| where admin does record-keeping, is corrupt. The best thing is to 


j remove the temporary file area and start from scratch with admin. Use 


j the command 


i rm -r /usr/lib/admin/iocal-data 


Cneeks that you are in single-user mode. You cannot perform system 

— 

initialization in multiuser mode. 


Prompts you for a hostname. See Section 3.3.1, "Choosing a 

/eic/hosts 

| Hostname". 

/eic/rc.local 

i 

1 inis must be a unique hostname on your local network. Enter a 

/usri spool/’ uucp /* ! 

j question mark (?) for help. 


! Prompts you for network controllers and internet addresses. See. 

■ ietc/kosts I 

1 Section 3.3.2, "Choosing a Network Address". 

icicfrc.local 

; If you have no network connections, you do not have to answer these 


prompts. You must enter this information for each network controller: 


• Controller name ffor example, “nwO” or l ‘ttyh3”) 


• Internet address (for example, ”1.0. 0.1”) 

i 

• Destination internet address, if the controller is a serial line 

i 

After collecting this information, admin verifies it before continuing. 


(corxinued or , ; next pace) i 
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Tabie 3-1. admin System Initialization (continued) 


What admin (8) Does 

Affected Files 

Prompts for the password administration mode. See Section 3.3.3, 
"Choosing a Password Administration Mode". 

Choose one of the foliow'ing: 

• Local 

. TCP/IP 

• Yellow Pages (you must have NFS) 


Having collected the necessary information, admin performs these 
initialization tasks: 

• Puts the hostname in Iciclrc.local (hostname (1)) 

• Puts network controller configurations in Iciclrc.local (ifconfig (8)) 

• Adds network information to Ictc/hosis (hosts (5)) 

• Sets up uucp directories and files 

— Creates lusrJspool/uucp 

— Creates configuration files in lusr/spool/uucp 

— Creates accounting files in lusr/spool 

— Changes ownership (uucp) and group ownership (daemon) of 
lusr'spool/uucp 

Icic/hosis 

Iciclrc.local 

lusrlspool/uucp 


3.4 Setting Up Terminals, Modems, and Printers 


The procedures in Sections 3.4.1, 3.4.2, and 3.4.3 tell how to set up terminal lines and how to specify the 
type of device connected to these lines. This includes connecting print device.* like line printers or letter 
quality printers. Refer to Section 4.6 for information on making new devices. 

Table 3-2 show's the type of cable needed to connect between peripherals and ports. See the appropriate 
Installation Manual for more details. 


“Standard” refers to a standard RS232C interface cable (also called 


“straight-through” cable). 


“Twisted” refers to a RS232C interface cable 
“null-modem” cable). 


with pins 2 and 3, and S and 20 swapped (also 


pallet 



Table 3-2. Ca 

oles for Periohera 

1 Pons 

1 Device 

! Console Port j 
or Port 0 ! 

Other 

Serial Pons 
(Ootimun V) ! 

Serial Ports j 

on an Optional 

r 1 

Q-Bus Breakout Box j 

: T f* rm i r° i v 

Standard 

Standard ! 

Twisted 1 

: Modems 

Twisted ! 

Tw-isted i 

Standard 


3.4.1 Defining Terminal Lines 
Suggested readme: 


r- / 
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• tset(l) 

• ttys (5) 

Define the system’s terminal lines in the file letc/ttys. Use Table 3-3 to find the hardware connections; the 
right side of the table shows how to name the terminal lines. 


Table 3-3. Terminal Line Names for /etc/ttys 


System 

Controller 

Number 
of Lines 

Name 

Optimum 

dh (ISDH) 

16 

ttyliX 

( X is hex, 0-f) 
ttviX for second DH 

dz (ISDZ) 

8 

ttyAA 

(XX is decimal, 00-07) 

Optimum V 
System' 

cp (VME-ICP8/X) 

8 

ttyhA' 

(X is hex, 0-7, or 0-f) 

Do not use lines ttyli[8-fj; use 
tty iX for second VME-ICP8/X 
ttyjA for third, etc. 

cp (VME-ICP16/X) 

16 

ttyliA' 

(X is hex, 0-0 

Optimum V 
Workstation 

ttyw 

16 

ttvwA' 

(X is hex, 0-0 

All 

i 

: 

std 


Console port: 1 

console ! 

(modems are controlled 
same as terminals) 


Dial-in lines (modems): j 

ttydA’ ! 

(X is hex, 0-0 j 

ptv 

1 

I 

i 


Pseudo-terminals (ptys): 
ttypA\ ptvpX or 
ttyq.A, ptyaA* 

(A’ is hex, 0-0 
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Use the following procedure, the Procedure to Define Terminal Lines, to define the terminal lines. 

Procedure to Define Terminal Lines 
ACTION WHAT IT DOES 

Step 1. Edit the file Iciclitys. Defines terminal lines with this format: 

tty getty type status comments 
where 

tty is the name for the line, from Table 3-3. 

getty is the command to execute for the line, 
usually a call to getty (8). This field is usually in 
quotes, as it contains more than one word. When 
calling getty, specify the baud rate for the line. 

type is the type of terminal usually connected to 
the line, as defined in /etc/termcap (termcap (5)). 
Some common types arc 

• unknown when you do not know the terminal 
type 

• vtlOO for the DEC VT100 and emulators 

• wvseSO for the Wyse 50 

• flOO for the Freedom 100 

• dialup for modems (tty dX) 

• network for pseudo-terminals (ttyp.Y) 

• iswindow for the Optimum V Workstation 
monitor 

status is one or more of the following: 

• on to enable this line 

• off to disable this line (the default) 

• secure to allow root logins on this line 

• desktop for an Optimum V Workstation 

• windows” command" to have init (S) execute 
the named command before starting getty. 

comments is a comment string that describes this 
line. 

Look in the file icicittys for examples, and see 

ttys (5). 

(continued on next page ) 
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Procedure to Define Terminal Lines (continued) 



ACTION 

WHAT IT DOES 

Step 2. 

Add lines or edit existing lines to 
reflect your site’s terminal lines. 

Tailor the Ictclttys file to your site, ictclttys should 
already contain line definitions; often all you need to 
do is choose the line you want to enable, and remove 
the initial character that comments the line. 

Step 3. 

If you change Ictclttys and want to 
implement the change immediately 
(for example, after enabling or 
disabling a terminal line), enter the 
command 

Sends a hangup signal to init (8), making init notice 
the change in Ictclttys. 

kill-1 1 

also works. 


# kill -HUP 1 


Step 5. 

cd to /dev and check that each 
terminal line enabled in Ictclttys 
has an associated special file in 
I dev. 

Gives UNIX a way of communicating with the 
terminal on that line. 

For example, if Ictclttys contains the line 

ttyis "/elc/getty sld.9600" vtlOO on 

Idcv must contain the file 



IdcvIttyiS 

Files named IdevlttyXX are special files; when UNIX 
writes to these files, it is actually writing to terminal 
screens. 



If Idev does not contain the necessary tty files, see 
Section 4.6. "Making New Devices in idcv." 

Step 6. 

Turn to "Appendix C: Config- 
uration Worksheet" and note any 
changes. 

Updates the reference sheet. 


End of 

'procedure 
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3.4.2 Setting Up a Modem 

Set up a modem just as a terminal. Note that in Table 3-3 dial-in lines have the name 
UydX 

where X is a hexadecimal digit signifying the port used on the serial controller. 

Use these steps to set up a modem port: 

1. Change the name of the / dev special file for that port. For example, for the ninth port (numbered 
from 0) of a VME-ICP1 6/X, change Idcv/ttyhS to /dcv/ttydS. 

2. Add the modem port to the file letc/ttys with a line 

ttvcLY "/etc/getty s id.baud" dialup on 
where X is the port number and baud is the baud rate. 

For example, for a 1200-baud modem on the twelfth port of a VME-1CP16/X, put 
ttyda "/etc/getty std.1200” dialup on 
in Ictclttys. Change Idevttiyha to /dev/ttyda. 

Use a "twisted" RS232C cable (“straight” on a Q-bus Optimum system breakout box) to connect the 
modem to the host port. Connect the modem to a phone line as instructed in the modem’s installation 
manual. 


When using a terminal and dialing in over the modem line, check that the terminal and modem baud rate at 
your end matches the baud rate at the host’s end. 

3.4.3 Setting Up a Printer 


You can connect a parallel printer or a serial printer to your system. The following Procedure to Connect a 
Printer describes the necessary steps. If you are connecting a parallel printer, skip Step 1 . 

Parallel printers connect to ISI systems in two different ways: 


On an Optimum system, you connect the parallel printer to the PRINTER port. 

On an Optimum V System or Workstation, you connect a parallel printer to the special port on the 
VME-ICP16/X (VME-ICP8/X) controller. 


muse a 


parallel printer does not have an entry in tele! ttys, you must configure the parallel printer driver 
in the UNIX kernel (see. "Section 4: Configuring Your System"). See Ip (4) for a description of the parallel 
i n T *r- 


erial printers connect to the system as serial devices, much like terminals, on an Optimum or Optimum V 
ystem or Workstation. 


"he line printer software svstem includes these files and commands: 


iusrtucbilpq 

tusr/ucb/lprm 

!usr!ucb!lpr 

ieiciprintcap 

fusrilib/lpd 

ietc.'lpc 

ieidhosis.lpd 


spooling queue examination program 
program to delete jobs from a queue 
program to enter a job in a printer queue 
printer configuration and capability data base 
line printer daemon, scans spooling queues 
line printer control program 
list of hosts allowed to use the printers 
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Procedure to Connect a Printer 



ACTION 

WHAT IT DOES 

Step 1. 

Skip this first step if you are 
connecting a parallel printer. 

Define the serial line as for a 
terminal (sec Section 3.4.1) with 
these exceptions in the file /etc/ttys: 

• Disable the printer line by 
specifying “off” in the status 
field. 

• Define the printer as a VT100 
terminal type. 

Sets up the printer with the necessary definitions for 
UNIX to reach the printer. The printer is essentially 
a disabled terminal; the “disabled” status simply 
means that getty (8) will not expect the printer to act 
like a terminal. 

For example, to describe a 9600-baud printer on the 
second port of a VME-ICP16/X controller, use 

ttyhl "/etc/getty std.9600" vtlOO off 

The “vtlOO” definition is a dummy; this is because 
letclttys relies on termcap (5) for its definitions. You 
define printers with printcap (5), as described in the 
next siep. 

Step 2. 

Define the printer in the file 
letclprintcap. The default 

definition, Ip, already in 

letclprintcap, will work for some 
printers. See printcap(5) to define 
other printers. 

Defines printer specifications so that UNIX can 
format output. The letclprintcap entry defines the 
baud rale and other characteristics of the printer, and 
assigns a name to the printer. Use this name to 
specify which letclprintcap entry applies to the 
printer; Ip is the default. 

See also the “Line Printer Spooler Manual” 
(SMM:6) in the UNIX System Manager' s Manual. 

Step 3. 

Check that the letc/rc command file 
contains a command to start the 
printer queue daemon lpd. The 
line in letarc should look like 

/usr/lib'lpd & 

Checks that ietc/rc initializes the printer daemon 
when the system boots. This daemon should be 
running at all times. 


(End 

of procedure) 
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3.5 Setting Up User Accounts 

Use the admin (8) program to add or change user information automatically. When you invoke admin (8) 
have this information ready: 

• Account name (user’s login name). The login name should be at least six characters long, for security, 
but you can use shorter names. 

• Group number (the group to which the user belongs). Look in laclgroup for existing groups or to form 
a new one. 

• User’s real name. 

• User’s home directory on this node (a fully-specified pathname). 

• User’s preferred UNIX shell (usually /bin/esh). 

• User’s home node, where s/he receives mail (for local networks). This will not be necessary if this 
node is under “local” admin (8) password administration. 

admin follows the steps in Table 3-4 when adding a user account. If you terminate the admin session 
before completing the procedure, the /ctclpasswd file will remain untouched. 

You might want to consider security and accounting needs on your system before you set up groups and 
users. If you need to restrict access to certain files by group or if you need to track system usage by group 
or department, you should separate users into different groups. Remember that members of the same group 
have access to all files created by that group, provided the group “read” permission is enabled (see 
chmod(l)). 
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Table 3-4. admin Adding User Accounts 


What admin (8) Does 

Affected Files 

Displays the top-level menu. 

— 

Choose item B, “User account maintenance.” 


Displays the user administration menu. 
Choose item A, “Add a user account.” 

— 

Prompts you for information about the user. 

Enter this information: • 

• login account name 

• group number 

• real name 

• home directory on this node 

• preferred shell 

• home node, where mail should go (for “TCP/IP” and “YP” 
password administration) 


Gives the new user a login account. The syntax of a new letclpasswd 
entry is this: 

namc:password:numbcr '.group :dcscripiion:homc:shcll 
where 

name is the login account name. 

password is the user’s encrypted password, admin provides an 
initial value for this password; you should give this temporary 

letclpasswd 

i 

| password to the user and encourage him/her to run passwd(l) after 

i 

logging in. 

| number is a unique account number for this login, admin chooses 
j the next available unique number on this node. Under “TCP/IP” or 
“YP” password administration, admin chooses a unique number 
with respect to all nodes under common administration. 

group is a grout? number. See group (5). 

! W ^ 

description is a brief description of the user, for use by finger (1). In 
this case, this held is simply the user's real name. 

i 


home is ihe user's home director}’. 

shell is the shell used by UNIX when the use: logs in. Most 4.3BSD 
users rre.e: /bin^esh. 


| Here is a sample ieicipassvd entry: j 

! suzanne:: 23: 10:Suzanne Koenigriu'suzanneribin/csh ! 

j Creates the user’s home director}-, as supplied to prompts above, j user's home 
| admin also changes ownership of the directory to the user’s account j directory 
| and installs default versions of .login, .logon:, and .csb'c hies. ! 7 .login 

i I 7 .logout 

| ! 7 .eshre 
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admin (8) provides the new user with default '/.login, '/.logout, and l.cshrc files. If you wish, you can 
build new ones for your site and install them manually after running admin. 

After installing .login, .logout, and .eshre files, use chown (8) to give ownership to the user. This sets up 
the environment for a new user at login, reducing the shock for a new user who is unfamiliar to UNIX. 

The .login file should contain commands to set up the terminal (for example, setenv TERM vtlOO), while 
the .eshre file should hold C-shell commands (for example, alias commands (esh (1)). 

Table 3-5 shows sample .login and .eshre files for new users, admin (8) provides different versions of 
these files as the default. 

The .login file executes once when the user logs in. The .eshre file executes every time a C-shell is 
invoked. For example, if you execute a “shell” command in vi and want to have your familiar prompt 
rather than die default “%” C-shell prompt, you should place the set prompt command in .eshre. 


Table 3-5. Sample .login and .eshre Files 


File 

Comments 

# Sample .login 

Comment (see csli (1) for the following commands) 

set prompi='\!# " 

Numbers each esh prompt for history commands 

set history=20 

history will remember 20 commands 

set padi=(Spath "/bin) 

Adds 7 bin to the command search path 

set mail=60 

Checks for new mail every minute (default 10 minutes) 

set notify 

Lets you know immediately when jobs finish 

set noclobber 

Helps protect files from accidental erasure 

set ignoreeof 

Prevents accidental logout from stray signals 

# Set terminal to vtlOO 

Comment (replace vtlOO with the terminal name) 

set noglob 

Local disable of variable expansion, for next line 

i set term=(‘tset -S -k ? vtlOO*) 

Prompts user for term type at each login, default vtlOO 

j setenv TERM Stermfl] 

Sets the environmental variable TERM 

j setenv TERMCAP Sterm[2] 

Sets the environmental variable TERMCAP ! 

■’ unset term, noglob 

j 

i 

j = Execute at login 

Comment (these commands run at login, before first prompt) | 

echo 

Throws a blank line (RETURN) j 

uptime 

Prints current time and system load 

echo 


msgs -fp ! 

Prints any system messages (mailed to msgs (1)) j 

echo i 

| 

?? Sample .eshre 

Comment (see esh (1) for alias command) I 

alias Is 5 ls -F ? 

Friendlier Is (1) command j 

alias rm ’rm -i’ i 

Prevents accidental removal of hies 

alias mv ! mv -i ! 

Same ; 

alias cp *cp -i’ 

Same j 

alias pd pushd 

Easier to type j 

alias ppd popd 

i 

alias m more 

! 

alias j jobs ! 

! 

alias c clear 

! 

alias n history i 

! 
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3.6 Setting Up a Mail System 

Electronic mail allows users to communicate with each other on a single node or across linked nodes. This 
section describes how to use the UNIX mail (binmail(l)) and Mail (mail (1)) commands. See Section 3.7, 
"Setting Up Uucp," for a description of networked mail systems (mailing between nodes). 

The program /bin/rnail (binmail (1)) invokes a simple mail facility, a holdover from Version 7 UNIX. 
/bin/mail is indeed simple, and it runs quickly, but it has little power and the interface is terse at best. For 
most purposes, use lusr/ucb/Mail, which is linked to lusrlucblmail (mail (1)). 

The environmental variable PATH determines which mail program executes when you enter the word mail 
to a esh prompt. If the path has /usrlucb before /bin, as the default path docs, UNIX uses /usr/ucbIMail. 
To override this, use the alias command 

alias mail /bin/mail 

or simply specify /bin/mail when you want that program. Entering Mail will always invoke /usrlucb/Mail. 

The default UNIX autoboot starts the mail facilities automatically. The default Ictclrc file rc (8) starts the 
comsat (8C) daemon (with the inetd (8) daemon), and /ctc/rc.local starts the sendmail (8) daemon. 

Unless something breaks, administering the mail system simply means ensuring that users know how to use 
. it. One way that you can help is to give new users a l.mailrc file, along with the .login and .eshre files, 
admin (8) does not provide a default .mailrc file as it does the others. Table 3-6 shows a sample .mailrc 
file. 


Table 3-6. Sample .mailrc File 


i File 

Comments 

j £ Sample .mailrc 

Comment (see mail for these commands) 

ignore message-id 

Clears extraneous trash from mail headers 

j ignore received 


ignore sender 


ignore status 


ignore date 


set ask 

Prompts for a Subject: line when you send mail 

set autoprint 

Speeds up reading mail 

set quiet 

Keeps screen uncluttered 

set EDITOR /usr/ueb/ex 

Chooses an editor for the edit command in mail 

set VISUAL /usr/bin/vi 

Chooses an editor for the visual command in mail 


.-mother cf your tasks is to maintain the syster 
to mail to a list of other people as a singie gro' 
r-en*v oeoole. Aliases rr.av themselves com 
definition 


aliases (5) file, iusr/lib 'mail-aliases. This nie allows users 
o. For example, engineering may be an alias that includes 
n aliases: engineering may have the tusrilib.'msU/ciiascs 


engineering: softeng hardeng techsupport 

where softeng. hardeng. and techsupport are previously-defined aliases, 
svstem. 


aliases (5) explains the alias 


ror further information on the 
Installation and Operation Guide 


mechanics of mail, see the “Mail Reference Manual” and 
” (SMM:7) in the UNIX System Manager' s Manual. 


“Sendmail 
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3.7 Setting Up Uucp 

Uucp (UNIX-to-UNIX copy) transfers files between nodes over a phone line. Use this to copy data 
between nodes or to connect the node to a distributed mail network. 

For networking connections involving an Ethernet board, see "Section 5: Setting Up Your Network." 

To connect two UNIX nodes with a uucp link, one site must have an automatic call unit and the other must 
have a dial-up line with an auto-answer modem. It is best if both sites have both. 

Uucp is complicated. The description in this secu'on outlines only the bare bones of installing and 
operating uucp. See “Uucp Implementation Description” (SMM:9) in the UNIX System Manager's 
Manual for more information. 

Uucp software resides in three major directories: lusr/bin (user commands), lusr/libluucp (system 
commands), and lusrl spooll uucp (spooling area). These commands are in lusr/bin : 

lusrlbinluucp file-copy command 

lusr/bin/uux remote execution command 

lusrl bin/uusend binary file transfer using mail 

lusrlbin/uuencode binary file encoder (for uusend (1C)) 
lusrlbin/uudecode binary file decoder (for uusend (1C)) 
lusr/binluulog scans session log files 

lusr/bin/uusnap gives a snapshot (summary) of uucp activity 
lusr/bin/uupoll polls remote system until an answer is received 
lusrl bin/ uunamc prints a list of known uucp hosts 

fusrlbin/uuq gives information about the queue 

These are the important files and commands in lusr/libluucp : 

lusrllibiuucpIL-devices list of dialers and hard-wired lines 
iusrliibiuucpIL-dialcodes dialcode abbreviations 

iusrliibiuucpIL. aliases hostname aliases 

lusrilibiuucp/L.cmds commands remote sites may execute 

lusrilibiuucpiL.sys systems to communicate with, how to connect, and when 

iusrilibiuucpiSEQF sequence numbering control file 

lusr/libluucp/USERFILE remote site pathname access specifications 

lusr/libluucpluucico uucp protocol daemon 

lusniib- uucpiuuciean cleans up garbage files in spool area 


iUSriilD-UU 

~p: llliXia i 

u: 

ucp remote 

1 execution 

server 


re spooling 

; 2J52 coma; 

ins these 

important 

files 

4^-t l Li LU 

.rec; 

1 ^ U • 


iusr spoor 

u u ~p • . 


directory 

for 

comm 

and. 

, “C.” 

files 

iusr. SPOOl- 

uucp D . 


directory 

for 

data. ‘ 

*D ; 

files 


iusr! spool 

uucp IX. 


directory 

♦ 

1 

comm 

and 

execut 

ion. “X. 

Iusr: spool 

uucp'-D. ma. 

chine 

director}’ 

for 

local ; 

i d: 

' files 


iusr. spool 

uucp ID. rna, 

chineA* 

directory 

for 


*\* ’ 
/V. 

’ files 


iusr: spool 

uucp.'TM. 


director}’ 

for 

tempo: 

rary 

, “TM 

.”, files 


iusr, spool uucpILOGFILE log file of uucp activity 

iusr spool ' uucpiSYSLOG log file of uucp file transfers 


Use the following procedure, the Procedure to Set Up Uucp. to set up uucp data bases and administer the 
uucp software. This procedure is very terse; again, refer to “Uucp Implementation Description” (SMM:9) 
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in the UNIX System Manager's Manual for more information. 


Step 1. 


Step 2. 


Step 3. 


Procedure to Set Up Uucp 

ACTION WHAT IT DOES 


Check that these files exist: 

/usr/spool/uucpID. node-name 
/usrlspool/uucp/D. nodc-namcX 

where “node-name” is the 
hostname of your node, as it will be 
used in mail addresses. 


Allows dialing in to other nodes. L-dcviccs lists 
modem lines, L-dialcodes gives abbreviations for 
phone numbers, and L.sys describes the nodes you 
can dial into, complete with logins and passwords. 

An additional file, L.cnids, defines the commands that 
may be executed by a remote host. 

files. 


If you have an autodialcr on the 
node, edit these files: 

I tisr/libl uucpIL-dcviccs 

/usrllib/uucpIL-dialcodcs 

lasr/libluucp/L.sys 

“Uucp Implementation Descrip- 
tion” gives the formats for these 


Checks for spooling directories, admin (8) sets up 
these two directories, with the proper name for your 
node, during admin initialization. Sec Section 3.3, 
"Initializing Your System." 


Use the commands 

uucp (1C) 
uusend (1C) 
uux (1C) 


Activates the phone lines and transfers files as 
ordered. Some sites specify certain times when they 
are available, and you cannot dial in outside those 
times. 


to send and receive information 
through uucp connections. 


Step A. 

Send mail through uucp connec- 
tions with the mail (1) command. 

Stores outgoing mail, then dials in to other nodes and 
delivers that mail. Also picks up incoming mail. 


See mailaddr (7) for the format of 
mail addresses through uucp 
connections. 

Make an entry in lusrilib/crontab (see cron (8)) to 
autodial to the mail addresses at given times. 


Step 5. 

Check uucp with the uulog (see 
uucp (1C)) command. 

Gives information on uucp use, indexed by nodes or 
by users. 

Step 6. 

As System Administrator, 

occasionally run the uuclean (S) 
command. 

Clears old files cut of the iusr! spool! uucp directories. 
Tnese can get out of hand quickly if not cleaned 
occasionally. 





3.8 Backing Up for Safety 

After finishing the procedures in this section, save a copy of the UNIX system on magnetic tape. Then you 
can quickly restore the system in case of disaster. 

Run a “level 0 dump” as described in Section 8.7, "Backing Up Your System." 

.Also, update "Appendix C: Configuration Worksheet" with any changes to the system configuration. 
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SECTION 4: CONFIGURING YOUR SYSTEM 


This section tells how to adjust the UNIX system for different devices. This includes adding peripheral 
devices and changing the UNIX kernel. 

Jf you are using a complete system shipped from Integrated Solutions, the system was completely 
configured at the factory. Use this section only if you want to change that shipped configuration. 

If you started the UNIX system from a release tape, follow these procedures to configure the system. 

This section contains die following subsections: 

4.1 When to Change Your Configuration 

4.2 Configuring the Kernel 

4.3 Configuring Disks 

4 .4 Selecting Tape Device Files 

4.5 Changing Your Hardware Configuration 

4.6 Making New Devices in l dev 


4.1 When to Change Your Configuration 
Reconfigure the system under these conditions: 

• Loading a fresh version of UNIX from tape 

• Adding user-written device drivers 

• Optimizing the kernel for efficiency 

• Changing hardware (adding or removing devices) 

All of these follow a general procedure: 

1. Make changes to hardware or device software 

2. Change the kernel while saving the old kernel 

3. Reboot with the new kernel and check modified functions 

4. Install the new kernel 


Keep a log of changes to the system in "Aopendix C: Configuration Worksheet. 


4.2 Configuring the Kernel 

The ‘'kernel” is the core of the T JN!X operating system. Without accurate information ir. the kernel, 
UNIX has no way to communicate with you or with peripheral devices. 

The kernel usually resides in the file ivmunix. When the system boots, this file is the starting point for 
UNIX’s operation. 

The 4.33 SD UNIX release tape includes a generic kernel with definitions for all bootable devices. When 
the system boots from this kernel, the autoboot software determines which devices exist 2 nd activate the 
associated son ware drivers. 
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4.2.1 Adding Your Own Device Drivers 

You can write your own drivers for devices other than those in the release kernel. This requires 
proficiency in the C language and experience with UNIX device drivers. Read Building Berkeley UNIX 
Kernels with Config (SMM:2) and intro (4) for advice. 

The following Procedure to Add Drivers to the Kernel shows the general procedure for adding new drivers 
to the kernel. 

/Vy) O UHT efts' 

Procedure to Add Drivers to the Kernel 



ACTION 

WHAT IT DOES 

Step 1 . 

Edit the files 

Isyslconfi files 
Isyslconfi devices. is6Sk 

Provides informa'.on for the device. Sec die 
comments in the ntes, and read Building Berkeley 
UNIX Kernels with Config (SMM:2). 

Step 2. 

Edit the file 

Isys/is6Sk/conf. c 
(or, for source licensees:) 
Isyslconfi machine! conf. c 

to add appropriate entries to the 
bdevsw and edevsw tables. 

Defines routines for access to the device. Sec the 
comments in the file itself. 

Step 3. 

Put the device driver, with a name 
of tiie form “dev.c”, in the 
directory lsys/is6Skdcv. 

This is where config (8) expects to find device 
drivers. 

Step 4. 

Edit the tile 
lsyslconflSYS_DIST 
where “SYS” is one of 
. V20 for the VME-6SK20 
. VI 0 for the VME-68K10 
• Q10 for the IS-6SK (Q-bus) 
to add the device driver. 

Defines the device driver for the kernel, so that 
UNIX can use the device. 

Look at the entries in the file, and read Building 
Berkeley UNIX Kernels with Config (SMM:2). 

Step 5. 

Make a new kernel, as described in 
Section -.2.3. 

Implements the new device driver; you can now test 
the device and driver. 

Step 6. 

Turn to ’’Appendix C: Config- 
uration Worksheet" and note any 
changes you made. 

Updates the reference sheet. 
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4.2.2 Optimizing Your Kernel for Efficiency 

Use this procedure to streamline the kernel for greater efficiency. 

A generic release kernel comes with definitions for many devices. Eliminating unused devices decreases 
the size of the kernel and allows UNIX to run faster. 

Use the following Procedure to Optimize the Kernel to reconfigure the kernel for best performance. 


Procedure to Optimize the Kernel 



ACTION 

WHAT IT DOES 

Step ]. 

Edit the file 
lsys/conf/SYS_DlST 
where “SYS” is one of 
. \ ’20 for the VME-68K20 
. VI 0 for the VME-68K10 
• Q10 for die 1S-68K (Q-bus) 

Locates file kernel definitions for what devices are in 
the system. The generic distribution kernel from 
Integrated Solutions defines all of the available 
devices. 

Step 2. 

Comment out any lines that do not 
apply to your configuration. A 
hash (#) at the beginning of a line 
comments out the line. 

Eliminates unneeded device definitions from the 
kernel. You should trim the definitions down to only 
those used on your system. 

Table 4-1 shows controller names and descriptions 
for Optimum Systems. Table 4-2 shows controller 
names and descriptions for Optimum V Systems and 
Worl Stations. 

Step 3. 

Change the “options” line(s), and 
other configuration definitions near 
the top of the file, to reflect your 
configuration. 

Assigns configuration variables and removes 
unwanted options in the kernel. See Tables 4-1 and 
4-2 for descriptions of options. 

The server node for cluster or diskless networks must 
define the maxusers line by this formula: 

maxusers is equal to fusers -f (6 x Anodes) 

where 

4-uscrs is the maximum number of users on the 
serve: node 

=r.odcs is the number of connected cluster or 
cis.ii iess nodes 

For example, a server node with eight users 
(maximum) and three diskless nodes would calculate 
(8 -f (6 x 5)), resulting in this config line: 

maxusers 26 

Step 4. 

Make a new kernel, as described in 
Section 4.2.3. 

Implements the kernel changes. You now have an 
optimized, faster system. 


End c 

■"procedure 
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Table 4-1. config Definitions for Optimum V Systems and Workstations 

Variable Type 

Name 

Description 

machine 

is68k 

The default, always defined 

cpu 

"M68020" 

VME-68K20 


"M68010" 

VME-68K10 

ident 

"V20" 

VME-68K20 


"V10” 

VME-68K10 

timezone 

n 

Number of hours west of GMT 


dst 

Daylight Savings Time 

maxusers 

n 

Number of users 

options 

VBUS 

GWS 

INET 

TRFS 

APPLETALK 

DEBUGGER 

ENETFILTER 

QUOTA 

TCP_COMPAT_42 

UDP_COMPAT_42 

Always defined 

Graphics 

Internet 

Transparent Remote File System 

AppleTalk 

Kernel debugger 

Remote booting over Ethernet 

Quotas for file system use 

Compatible with 4.2BSD TCP 

Compatible with 4.2BSD UDP 

config 

vmunix 

The default, always defined 

controller 

(main) 

QBO 

at nexus ? 

The default, always defined 

controller 

(disk) 

SD{0,1) 

YDS 106 


SM{0,1,2) 

VDS269, VDS418, VDS494 


SPO 1 

Spanned disk 


LD(0,1 } 1 

Optical disk 

controller I 

froTv^ ! 

IS {0.1} ! 

! 

VTS25/R, V7S50/R, VTS6250/R | 

controller j 

(serial) ! 

CP{0,1] 

VME-1CP16/X, VME-ICP8/X 

controller | 

(Fr?) 

SKO : 

i 

l 

VME-FF? Fast Floating Point board j 

i 

controller j 

(Ethernet) | 

NW {0,1} i 

i 

YME-ECX | 

j 


EX r 0,lj 

VMZ-EC (Ex cel an - ' 

controller j 

(cluster) 

V30 i 

Cluster nodes j 

pseudo-device 


Ethernet for TRFS ! 

1 

imp 

internet IMP for INET ! 

| 

loop ; 

Internet loopback for INET 

! 

pty I 

Pseudo-terminals j 

j 

rd i 

Remote disk j 

i 

si 8 I 

Serial line for INET j 


Vty : 

Graphics I 
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Table 4-2. config Definitions for Optimum Systems 


Variable Type 

Name 

Description 

machine 

is68k 

The default, always defined 

cpu 

"M68010" 

1S-68K (Q-bus) 

idcnt 

"Q10" 

IS-68K (Q-bus) 

timezone 

n 

Number of hours west of GMT 


dst 

Daylight Savings Time 

maxusers ‘ 

n 

Number of users 

options 

QBUS 

INET 

TRFS 

APPLETALK 

DEBUGGER 

ENETFILTER 

QUOTA 

T C P_C 0 MP AT_4 2 
UDP_COMPAT_42 

Always defined 
Internet 

Transparent Remote File System 

AppleTalk 

Kernel debugger 

Remote booting over Ethernet 

Quotas for file system use 

Compatible with 4.2BSD TCP 

Compatible with 4.2BSD UDP 

con fig 

vmunix 

The default, always defined 

controller 

(main) 

QBO 

at nexus ? 

The default, always defined 

controller 

EL{0,1 ) 

DS36. DS67, DS85, DS140 

(disk) 

HP{0,1 } 

DS33, DS418, DS474 | 


SPO 

Spanned disk j 

controller 

(tape) 

TS (0,1 ) 

TS25, TS50 

| controller [ 

DZ{0-7) ! 

ISDZ 

! (serial) { 

DH(0-7 ) | 

ISDH ! 

1 controller { 

i (printer) 1 

I_P ( 0-3 } i 

1SLP line printer board 

controller j 

(?FP) | 

SKO | 

1 

ISFFP Fast Floating Point board j 

controller j_ 

HX{0.1) | 

ISEC 

("Ethemef) ! 

EL {0,1 ) i 

Interian Ethernet 

controller 
(H?iB) ! 

130 | 

IEEE-488 (HPIB) , 

pseudo-derice | 

wihcr 

Ethernet for TRE S 


i imp 

Internet IMP for INET 

f loop 

: Internet loopback for INET i 

! P'4' 

' Pseudo-terminals 

I rd 

; Remote disk 1 

i si 8 

; Serial line lor INET 
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4.2.3 Making a New Kernel 
You must create a new kernel when 

• You have changed your hardware configuration 

• You have changed files in /sys/conf 

In any case, you should already have edited the file /sys/conf/SYS_DIST before reaching this procedure. 
Use the following Procedure to. Make a New Kernel to create a new kernel from the /sys/conf files with 
config(8). 


Procedure to Make a New Kernel 


ACTION 


WHAT IT DOES 


Step 1 . In the directory /sys/conf, create a 
(or edit an existing) config(8) 
configuration file. 

If you have completed the 
procedures in either Section 4.2.1 
or 4.2.2, you have already 
completed this step. 


Creates the configuration file that config(8) uses to 
build the new kernel. The original distribution 
configuration files from ISI have the names 

fsys/co nf/V2 0_D1ST 
/sys/conf IV] 0_DIST 
/sys/ conf/Ql 0_DIST 

You can edit the appropriate file for your system, or 
you can copy the original to a new file name and use 
the new file as the configuration file. 


Step 2. 


If you are using a configuration file 
with a name different from the 
original ISI distribution files, enter 
the command 

vt ^\V</ 


Crcates-a-directory in /sys .. for- kernel files. This 
director)’ already" exists for the ISI distribution config 
files. 


mkdir /s\&/name 


\j > ) 


where name is the name of the 
configuration file in / sys/conf , . 


Step 3. Enter these commands: 

cd /'svs/conf 
config -o name 

where name is the name of the 
configuration file. 


Runs the config (S) program on the configuration file. 
See Building Berkeley UNIX Kernels with Confg 
(SMM:2) for details on config operations. 

If you are a source customer, do not use the -o 
option. 


Sl£ 

r, fL 

renter these commands: 

Generates the ru 

lies for source code dependencies in 



cd /sys! name 

the kernel files. 




make depend 

config created t 

he Makefile in this directory in the 



where name is the name 

r , last step, 

cf the 




configuration file. 



(continued on next pace) 


\/ 


0 
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Procedure to Make a New Kernel (continued) 



ACTION 

WHAT IT DOES 

Step 5. 

Enter the command 
make vmunix 

Creates a bootable kernel file named vmunix in the 
current directory. 

Step 6. 

Enter the command 
cp vmunix /vmunix.new 

Copies the new kernel to a file /vmunix.new in the 
root director)' (/). 

CAUTION 



Do not replace the old kernel until 
you have tested the new one. 

Step 7. 

Reboot the system with the 
shutdown (8) and reboot (8) 

commands, as described in Section 
2.4, "Shutting Down the System." 
Continue until the PROM prompt 
(:) appears. 

Shuts down UNIX, bringing the system down to the 
boot PROMs. You can now reboot with the new 
kernel. 

Step 8. 

Enter this command at the PROM 
prompt (:): 

dcv(0,0)vmunix.new 

where dev is the name of the 
system’s boot disk. 

Boots UNIX with the new kernel. Note that this bool 
procedure is identical to the usual boot procedure 
except for specifying vmunix.new rather than vmunix 
as the kernel. 

Step 9. 

If the system boots, install the new 
kernel with these commands: 

Moves the new kernel to /vmunix. UNIX will now 
use this kernel for autobooting. 


mv /vmunix /vmunix.orig 
mv /vmunix.new /vmunix 

Always save the previous kernel as a backup. Write 
the name of the backup kernel in "Appendix C: 
Configuration Worksheet," under “Comments.” 

End of procedure 


4.3 Configuring Disks 

There are four main reasons for changing the disk configuration: 

• Adding a disk to the system (or taking one away) 

• Optimizing disk efficiency 

• Creating a spanned disk 

• A ccing a new nle system 
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4.3.1 Adding or Removing a Disk 

When you add or remove a disk, you must make changes to some of the system files. See Section 4.5, 
"Changing Your Hardware Configuration," for procedures that tell you which files must change when you 
change hardware. 

After you add (or remove) a disk, you must decide how to allocate file systems across the new (or 
remaining) disks. Section 4.3.2, "Optimizing Disk Efficiency," describes file system allocation. 

You can also allocate file systems across physical disk boundaries. This type of disk allocation is called a 
spanned disk and changes previous restrictions on file system size and file system location. (Prior versions 
of UNIX restricted file systems to a single disk partition.) Section 4.3.3, "Creating a Spanned Disk," 
describes how to set up a spanned disk. 

4.3.2 Optimizing Disk Efficiency 

Every physical disk drive has seven or eight partitions, labeled a-g[hj. Typically, UNIX uses the partitions 
in this way: 

a: Holds the root (/) file system or a backup copy of it. 

b: Holds a paging and swapping area. 

c: A dummy partition; actually refers to the enlire disk. Note that this includes all partitions ( a-gfh ]) 

plus sector maps created by badl44 (8). 

g: The largest area, contains the d, e, and / partitions, used for large file systems. 

h: On larger drives, typically used for user files. 

Assign file systems to these partitions in such a way as to balance system load and optimize speed. 

To balance the disk load, you must allocate five areas across the available disk partitions: 


1. The root (/) file system 

2. The itmp file system 

3. The iusr file system 


4. The user files (login accounts) 

5. Paging activity 

With one disk, you have at least three partitions (a. b, and g) for allocation; with two disks you have a: least 
six total partitions and so on. Clearly, with one small disk, you must double up some of the areas in the list 


stove. 


'able 


snows 


suggested division for disk allocation with one, two, or three disks. 


Table 4-3. Exanoie of Disk Allocation 


Areas 

| 

Number 
of Disks 



1 


i 3 

■ 

Oa 

('a 

! Oa 

■irr.D 

Oa 

la 

l la 

rusr 

Og 

Og 

! o g 

users 

Og 

Ig 

j 1 a. 2c 

paging 

Ob 

Ob. lb 

; Ob. ib, 2b 


Use the following procedure, the Procedure to Change the Disk Configuration, to reapportion disk- 
resources. 
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Step 1. 


Procedure to Change the Disk Configuration 

ACTION WHAT IT DOES 


Edit the file Ictclfstab. In this file, 
list the disk partitions you want to 
use, and what file systems you want 
to mount on them. Table 
4-3 suggests some file system 
allocations. 

See Step 4 to add a second swap 
space (a swap space on another 
disk). Partition b on the first disk is 
always assumed as a swap space 
and needs no entry in Ictclfstab. 


Assigns file systems to disk partitions, mount (8) 
these file systems automatically with the mount -a 
command. 

Use this format for an fstab (5) entry: 
devpart file system type options freq pass 
where 

devpart is the name of the disk partition, as defined 
in the I dev directory. For example, the g partition 
of a second SD disk in an Optimum V system 
would be Idcvlsdlg. 

filesystem is the file system that you want to mount 
on this disk partition. 

type is die type of file system, from these choices: 

• 4.3 for a standard block special device 

• nfs for remote disk access with NFS 

• swap for a swap partition 

• ignore for an unused fstab entry 

options is is a comma-separated list of options, as 
described under fstab (5). 

freq is the dump frequency, in days, for this file 
system (see dump (8)). 

pass is the order in which fsck (8) tests these file 
systems. 

For example, the fstab entry 
/dev/sdOa / 4.3 rw 1 1 


connects the root file system (/) to icevisdOa. a 
standard UNIX block device, in read/write mode, 
dump (8) will recommend backups for this file 
system every day, and fsck (8) will check this file 
system before all others. 
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Procedure to Change the Disk Configuration (continued) 


ACTION WHAT IT DOES 


Enter these commands: 
dmesg 

diskpart -d disktypc 

where disktypc is the type of the 
system disk, from Table A-4. 


Check that all of the file systems 
referenced in /etc If stab already 
exist. 

• If ietdfstab refers to a imnt file 
system, for example, check that 
the root director)’ (/) has a 
directory mm in it. 

• If Ietdfstab refers to a partition 
sdlg, for example, check that 
there is a special hie idev-sdl s. 


If you want to create a swap space 
on the second disk, continue with 
this procedure. Otherwise, stop 


Ago this line to leidjsiao: 

devpar ; ? swap 


ccvpar: is the partition of the 
second disk for use as swap 
space (for example, sdlb). 

? is any character or string, 
ignored but necessary to fill the 
“filesvstem” field of the fstab 


Compares the expected disk configuration to the 
actual configuration, dmesg (8) shows what the 
kernel thinks of as disk configuration, and 
diskpart (8) shows the entry from /elc/disktab. The 
two should match, with diskpart showing one or two 
fewer cylinders than dmesg. 

dmesg prints for each disk drive the partition sizes 
and a line of this form: 

(sector si track x tracks! cylinder x # cylinders ) 

If diskpart shows sector or track counts different 
from dmesg, use diskpart to change the entry in 
Ictcldisktab. See disktab(5) and the comments in 
letc/disktab for the format of disktab entries. 

diskpart should show one or two fewer cylinders 
than dmesg. The extra cylinders shown by dmesg 
contain bad block information. See bad!44 (8). 


Checks that everything is in place for UNIX to 
implement your disk partitioning. 

If either of these checks fails, use the procedure in 
Section 4.3.4 to create a new file system. 

If you have only one disk, you are now done with this 
procedure. 


Defines a swap space on the second disk. UNIX will 
now mount this swap space as part of the autoboot 
(see swapon (8)). 

letc fstab should look something like this: 

/dev/sdOa / 4.3 rw 1 1 
/'dev/sdOg / usr 4.3 rw.noquota 1 3 
/dev/sdla /imp 4.3 rw 1 1 
/dev/sdlg / u 4.3 rw 1 4 
/dev/sdlb ? swap 
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Procedure to Change the Disk Configuration (continued) 



ACTION 

WHAT IT DOES 

. Step 5. 

Add this line to letclrc.local: 
swapon -a 

Activates all swap devices listed in /etc/fstab. 
Without this line in letclrc.local, swapping and 
paging occur on the default partition only. 

Step 6. 

Enter the command 
cd /usr/sys/conf 

Edit the appropriate configuration 
source file by finding the line 

con fig vmunix 

and replacing it with 

Defines the swap areas for UNIX. This information 
is part of the kernel. 

For example, to add the b partition on device number 
2 for the gd disk of an Optimum V system, enter 

config vmunix swap on gdOb and gd2b 


config vmunix swap on 
dcvOb and devXpart 



where dev is the device name, X is 
the device number, and part is the 
partition. 


Step 7. 

Remake the kernel as described in 
Section 4.2.3. 

Implements die change by providing a new kernel 
with the new swap information. You do not need to 
change the config (8) configuration file for the kernel. 


End of procedure 
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4.3.3 Creating a Spanned Disk 

By using a spanned disk, you can create a file system that is larger than a single physical disk, or that 
combines partitions of multiple disks. Without spanned disks, a UNIX file system is limited to a single 
disk partition. 

A spanned disk is useful, for example, when you have several small partitions on two (or more) disk drives 
and you want to combine these small partitions for one single file system. Or, you might have a case where 
even one large partition is not big enough; you can add partitions from other drives until you reach the 
desired size. 

You can define up to four (4) spanned disks, spOc through sp3c. 

You may not use a spanned disk under these conditions: 

• The root file system (/) may not reside on a spanned disk. 

• The swap area may not reside on a spanned disk. 

• You may not use the c partition as part of any spanned disk. Instead, if you want to use an entire disk 
as part of a spanned disk, specify entries for the a, b , d, e,f, g (and, if available, h) partitions. 

The following Procedure to Create Spanned Disks outlines the steps for dynamically allocating a spanned 
disk. See sp (41) for further details. 

Procedure to Create Spanned Disks 

ACTION WHAT IT DOES 

Siepl. Determine the (major, minor) pairs 
of each partition that makes up the 
spanned disk. 

The major number refers to the 
controller type (see intro (4) ) for 
the disk drive that your system 
uses. 

The minor number refers to the 
partition number. 


r, - _ 

J i ty - . 

.Add the spanned disk description to 
ieicfsptab. For example, the two 
iines below describe two spanned 
disks: 

The first spanned disk, spOc, consists of drive 0, 
partition g. and drive I, partition /. The second 
spanned disk, splc, consists of drive 1, partitions a, 
c, and e. 


spOc ( (1.6), (1.13) ) 
sp lc ( (1.8). (1.11). (1.12) ) 

See diskpart (5) for information on how to list 
partition sizes on various disks. 


(continued on next page) 


The (major, minor) entries you create in letc/sptab tell 
the spanned disk driver how to configure the spanned 
disks. 

To determine major and minor device numbers, use 
the command 

Is -1 /d exIdevNp 

as described in Section 4.3.2, "Optimizing Disk 
Efficiency." 

The Is -1 command shows the major and minor 
numbers for the device. For example, this command 
shows the (maior.minor) pair (1.6) for the g partition 
cf a YDS 106 disk: 

F Is -1 / dev/sd'Jg 

trw 1 root 1, 6 Aug 5 1986 /dev/sdOg 
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Procedure to Create Spanned Disks (continued) 



ACTION 

WHAT IT DOES 

Step 3. 

Edit the file letclfstab to assign file 
systems to the spanned disk(s). 

Associates the spanned disk with a file system, and 
defines file system parameters. See fstab (5) and 
Section 4.3.2, "Optimizing Disk Efficiency." 

For example, this fstab entry defines a spanned disk 
holding the lusr file system: 

/dev/spOc /usr 4.3 rvv 1 2 

Step 4. 

Enter these commands: 
cd /dev 

MAKEDEV spO spl sp2 sp3 

where you specify to the 
MAKEDEV command only the 
spanned disks you have defined in 
leic/sptab. 

Creates device special files in the /dev directory for 
the spanned disk(s). 

For more information on / dcvIMAKEDEV , sec 
Section 4.6, "Making New Devices in /dev." 

Step 5. 

Manually invoke speonfig using 
the -a option. Enter the command 

/etc/spconfig -a 

This causes the system to recognize the spanned disk 
configuration immediately. 

Step 6. 

Add a call to speonfig in /ctclrc 
with a line of the form: 

/etc/spconfig -a 

This causes the system to recognize the spanned disk 
configuration during subsequent boot procedures. 
Place this line before any references to mount (8) or 
fsck (8). 

Step 7. 

Make a file system for this spanned 
disk with the mkfs (8) command. 

Defines the file system for this disk. You must use 
the mkfs (8) command, as described in the sp (41) 
man page, rather than the newl's (8) command. 

You can now mount (8) and use the new file system. 


End of 

procedure 


If you want to modify a spanned disk configuration, follow the steps shown in the Procedure to Modify a 
Scanned Disk. 

.Ail changes to spanned disk configurations must be done while in single-user mode with all file systems 
unmounted. 
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Procedure to Modify a Spanned Disk 



ACTION 

WHAT IT DOES 

Step 1. 

If the spanned disk already has a 
file system on it, dump (8) the file 
system to tape. 

Saves an existing file system. You can restore the 
file system to the reconfigured spanned disk after the 
end of this procedure. 

See Section 8.7, "Backing Up Your System," for 
instructions to dump (and later restore) the file 
system. 

Step 2. 

Boot UNIX to single-user mode. 
Unmount all file systems with the 
command 

umount -a 

Prepares for changes to the spanned disk 
configuration. You must be in single-user mode with 
the file systems unmounted. 

Step 3. 

Edit the file /ctclsptab. Change all 
(major, minor) pairs to 0,0. 

Resets the spanned disk configuration. 

Step 4. 

Type the command 
/etc/spconfig -a 

Dcconfigurcs the existing spanned disk(s). 

Step 5. 

Edit the file /ctclsptab. Change all 
(major, minor) pairs to match the 
new configuration for the spanned 
disk(s). 

Defines the new spanned disk configuration. 

Step 6. 

Type the command 
/etc/'spconfig -a 

Configures the new spanned disk(s). 

Step 7. 

If you have changed the size of the 
spanned disk, you must use the 
mkfs (8) command to create a new 
file system for the disk. 

Makes a new file system to fit the modified spanned 
disk. You must use the mkfs (8) command, as 
described in the sp (41) man page, rather than the 
newfs (8) command. 

You can now mount (8) and use the new file system. 


End of 

procedure 
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4.3.4 Adding a New File System 

You may want to make a new file system when you find that some part of an existing file system is growing 
beyond available space. For example, if you currently keep user accounts in the lusr file system, you may 
want to create a lu file system on a second disk. 

The following Procedure to Make a New File System assumes that you know what file system you want to 
create and on what disk partition you want it. 


Step 7. 


Step 2. 


Procedure to Make a New File System 

ACTION WHAT IT DOES 


Enter the command 
cd /dev; Is 


Lists the contents of the Idev directory. Check that 
die desired disk partition is one of the entries in this 
directory. 

The entry should be of the form 
dcvNp 
where 

dev is the name of the disk, from Table A-l 

N is the device number (0 for the first disk, and so 
on) 

p is the partition, a letter a-h 

If it is not there, use the MAKEDEV script to create 
it. See Section 4.6, "Making New Devices in Idev." 


Enter this command: 
newfs idtvir devpart diskrype 
where 

i devpart is the disk partition (for 
example, sdOg). Do no: fergst 
the /dev/r before devpart. (For 
an Optimum System, with a Q- 
bus, leave, out the r.) 

diskrype is the type of disk. Use 
the name from the /e:c>dis)::ab 
entry (for example, ved!06) (see 
Table A -4). 


NOTE 

SMD-type devices are numbered smO, 

sm2, sm4. and so on. 

Readies the disk partition for use with a file system, 
newfs (8) will print some information about available 
SD3CC. 

For example, to create a new hie system on the g 
partition of the second 106-Mbyte disk (VED106) of 
your Optimum V system, enter 

newfs /dev/rsdlg vedl06 

NOTE 

You must use mkfs(8) rather than newfs 
to configure a spanned disk. See sp (41). 


(continued on next page) 
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Procedure to Make a New File System ( continued ) 



ACTION 

WHAT IT DOES 

Step 3. 

Enter the command 
Is -F dir 

where dir is the director}' in which 
you want to put die file system. 
For example, to list the lusr file 
system, use 

Is -F / 

Shows the contents of the parent directory for the file 
system. Check that the file system already exists in 
this director}'; you cannot mount a directory that does 
not exist. The -F option to Is (1) prints a slash (/) 
after directories in the list. Therefore, for a /mnt file 
system, you should sec mnt/ in the root (/) directory. 

If the desired directory does not exist, create it with 
the mkdir(l) command. 

Step 4. 

Enter this command: 
mount /d e\! devpart directory 
where 

devpart is the disk partition (for 
example, sm2g). Do not forget 
the /dev/ before devpart. 

directory is the path to the head 
of the file system (for example, 
/mnt) 

Mounts the file system on the requested director}'. 

For example, to mount the file system hi on the g 
partition of the second 418-Mbyte (VED418) disk of 
your Optimum V system, enter 

mount /dev/sm2g /u 

Step 5. 

Edit the file letc/fstab to assign the 
file system to a disk partition. 

Associates the file system with a disk partition, and 
defines file system parameters. See. fstab(5) and 
Section 4.3.2, "Optimizing Disk Efficiency." 

For example, this fstab entry defines a /usr file 
system on the seventh (g) partition of a YDS 106 disk: 

/dev/sdOg /usr 4.3 r\v 1 2 


End of procedure 


4.4 Selecting Tape Device Files 


Tape device spec 
director}’ provide 
standard r.amina 
the directcrv idc\ 


ial files reside in the directory /dev, with names of the form *mt*. However, the /devhape 
s a iarger set of tape device special files. Tape device files are still available through the 
convention (such as m:0, rrr,:12, etc.) but the standard names are linked to tape devices in 
'/tape. You can use the standard dies, or you can use the wider variety of tape devices in 


tl.. 



The tape devices in idev/tape fill into three basic families: 

• q2~ — conforms to QIC-24 format specifications 

• all — conforms to QIC- 1 1 format specifications 

• old — the default format, se: by IS I to QIC-24 format specifications 

Filenames in the Idev/tape director}’ consist of descriptive strings connected by underscores. Tne filename 
describes the function of the tape, device. For example, the tape- de-. ..e sid_blk_n o rcw_0 is the default, 
logical-block-mode, non-rewinding device for the first tape drive (tsO). This tape device happens to be 
linked to idevimtd and / devinmtO . 
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This is the syntax for filenames in the Idcvltape directory: 
format _<featiire _...> drive# 
where 

formal is as defined in Table 44. 

feature is any of blk, chr, dens, f512, swap, or norew, as defined in Table 44. 

drive# is the drive number, 0 for the first drive, 1 for the second, and so forth. 

Table 44 shows the meanings for each string in the Idcvltape filenames. Table 4*5 shows the links 
between Idcvltape files and the older filenames in Idev. 


Table 4-4. Filename Strings for Idcvltape Tape Device Files 


in 

Meaning 

blk 

Block mode. Data is written to and read from die tape in equal-sized blocks, defined by 
the tape device block size. Each block is a separate read or write operation for the tape 
drive. Ever)' tape device must use cither “blk” mode or “chr” mode. 

chr 

Character (variable length) mode. Data is written to and read from the tape in records of 
variable length. Each tape record begins with a definition of record length, allowing the 
tape drive to read or write the entire record in one operation. Ever)’ tape device must use 
either “chr” mode or “blk” mode. 

dens 

Variable density mode. Half-inch tape drives ordinarily operate at 1600 bits per inch 
(bpi). The “dens” mode takes advantage of optional 3200/6250 bpi capabilities in some 
tape drives. The desired density should be selected by a switch on the tape drive. 

(Note: the UNIX tape driver does not currently support the “dens” flag. The hardware 
switch on the drive itself is sufficient for selecting higher density operations.) 

| f512 

I i 

j i 

| | 

The tape drive will transfer “raw” data, stripped of the usual header and format bytes. 
The block size on the tape is dependent upon the block size used by the individual tape 
controller. ! 

j swap j 

Byte-swapping mode. In this mode, the order of upper and lower bytes is reversed. This 
is for VAX compatibility. 

norew 

I 

1 

Non-rewinding mode. In inis mode, the tape drive will not rewind at the completion of a 
“close” operation. The tape drive pointer will be positioned at the beginning of the next 
record on the taoe. 


Configuring Your System 


4-17 









SMM:1 


System Administrator Guide 


Table 4-5. ! dev! tape Links to I dev Filenames 


/dcv/iapc Filename 

/dev Filename 

std_blk_0 

mtO 

std_chr_0 

rmtO 

std blk norew 0 

nmtO 

std blk norcw 0 

mt4 

std chr norew 0 

nrmtO 

•std_chr_norcw__0 

rml4 

sid_blk_swap_0 

smtO 

std_clir_swap_0 

srmtO 

std_blk_swap_norew_0 

snmlO 

std_chr_swap_norew_0 

snrmtO 

std blk dens 0 

ml8 

std chr dens 0 

rmt8 

std blk dens norew 0 

mtl2 

std blk dens norew 0 

nmt8 

std chr dens norew 0 

nrmt8 

std_chr_dens_norcw_0 

rmtl2 


4.5 Changing Your Hardware Configuration 

Table 4-6 shows the files to change for each hardware change you can make to the system. Use these 
general steps to change hardware: 

1. Make software changes 

2. Remake the kernel if necessary (see Section 4.2.3) 

3. Make new special files in /dev if necessary (see Section 4.6) 

4. Shut down the system with the shutdown (8) command 

5. Change hardware 

6. Reboot the system with autoboot 

7. Check for proper function 

S. Note changes in "Appendix C: Configuration Worksheet" 
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Table 4-6. Files Affected by Hardware Change 


Device 

File 

Change 

Disk 

/sys/conflS Y SJDJST 

/sys/SYS_DIST/ 

/dev/devpart 

/dev/rdevpart 

Ictcldisktab 

Ictclfstab 

/cic/sptab 

/sy's/SYS D1 ST/swapvmunix. c 
/sys/SYS DJSTIspconfig.c 

Add appropriate driver 
(Only one driver if several 
disks arc the same type) 

For user-written drivers 
One file for each partition 
Raw file for each partition 
Definitions of disks 
Allocate partitions 
Allocate spanned-disk partitions 
Add second swap area 
Allocate spanned-disk partitions 

Tape 

/sys/conf/S Y S_DJST 
Idcvl lapel* ldcv/mt?, 

Idcvlrml?, /devlsml?, 

Idcv/srml?, /dev/nmt? , 

idev/nrmt? , /dcv/snml?, 

Idev/snrmt? 

Add appropriate driver 
Files for various modes 
(sec mtio(4)) 

Raw files for tape 

Terminals 

/s)’s/conf/SYS_DIST 

Icldtiys 
leicltermcap 
/dev /try?? 

Add driver for controller 
(for example, for VME-ICP16/X) 
Define each terminal line 
Definitions of terminal types 
Special files for terminals 

Ethernet 

Isys/conf!? YS_DIST 
/dev/pry? 

Idev/ttyp? 

Ictc/rc 
/ erc/rc.local 
ietciineid.conf 

Add appropriate driver 
Pseudo-terminals for network 
Pseudo-terminals for network 
Start up network daemons 
More network daemons j 

Internet daemons ! 




Ir-s conf;SYS_DIST 
ieic/rc. local 


| Add SKO to controllers 
j Stan up ieic/fpini: 
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4.6 Making New Devices in / dev 

Make new files in Idev under these conditions: 

• Adding a disk or tape drive 

• Changing model of disk or tape drive 

• Adding a terminal controller 

• Creating pseudo-terminals (ply) 

• Creating graphics devices (ityw) 

• Creating devices for remote booting on Ethernet (cnct) 

• Adding a parallel printer 

Make new device files with the MAKEDEV script in Idev. Use die following Procedure to Make New 
Devices in Idev to make new devices files. 


Procedure to Make New Devices in Idev 

ACTION WHAT IT DOES 

Sicp 1 . Enter the command Moves to the Idev directory. 

cd / dev 

Step 2. Use the Is (1) command to list the Avoids redundancy. If the files you need are already 

special files in this directory. there, stop this procedure now. 

Check that the special files you 
need (see Table 4-7) do not already 

exist. 

Step S. Enter the command Makes the required special files. 


MAKEDEV name N . . . 
where 


name is the name of the device, 
from Table --7. 


N is the number of the device: 
usually 0 for the first one. 1 for 
the second device of the same 


type, and so on. SMD-;vpe disks 
are numbered 0 for the first one, 
2 for the second SMD-type 
device. 4 for the third SMD-type 
device, and so on. 


Usually a single MAKEDEV command will generate 
several files. Table 4-7 shows the files generated by 
each command. 

Note that Table 4-7 combines devices from all ISI 
systems. You cannot make some of these devices on 
your system. To check which devices your system 
supports, read the comments in 'dev! MAKEDEV 

For example, to make special files for two 105-Mbyte 
disks and one 75-11 tape drive on you: Optimum V 
system, enter 

MAKEDEV sdO sdl tsO 


Note that there is no space between 
name and A". 


End cf procedure 
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Table 4-7. Arguments to the MAKEDEV Command 


Device 

Type 

Name for 
MAKEDEV 

Files Created 

Standard 

console 

std 

console 

devices 

drum 


drum 


mem 


mem 


null 


null 


ttyO 


ttyO 


tty 




ttyw 


ttywO, ttyw] 

Disks 

SMD-lype disks 




on Optimum 

hp 

/t/?[0-7][a-h], r/i/jf0-7]fa-h] 


5%-inch disks 




on Optimum 

cl 

e/[0-7]fa-h], rc/[0-7]fa-h] 


SMD-typc disks 




on Optimum V 

sm 

„wz[0-7] [a-h] , rsm[ 0-7] [a-h] 


5’/4-inch disks 




on Optimum V 

sd 

jrf[0-7]ra-h], r.vrff0-7]fa-h] 

Tape 

TS-11 emulation 

is 

ri, -[0,4 ,8, 12], rm/fO.4,; 8, 12], 




wn/[0,8], /zrm/[0,8] 




non-swap devices, for half-inch 




tape drives only, begin with s: 




jmr[0,4.S,12],jrm/[0,4,8,12], 




j/jm/[0,8], jzzrm/[0,S] 




second unit increments numbers j 




by 1: 

i 



/m[1.5,9,13], rm/[l,5,9,13], 

! 

1 



nm:{ 1 ,9], nrmt[ 1,9] 

! ! 

i 


and so on 

■ T erminal i 

VME-ICPS/X j 

cp[C-3] 

:rv[h-k][0-C ! 

j con iron ers j 

i 


(use only the first eight) 


VME-ICP16/X 

cpEO-3] 

rry[h-k][Q-f] 


ISDH 

dh 

?O’[h-k][0-f] 


ISD2 

dz 

ny[0- /] l 0- / j 


j Graphics 
■ terminal 

I Workstation 

! txyw 

i tty^\2’f],fon! i 

; Pseudo- 

: ptys 

pty [0-2] 

; crvlp-r' "0-fi" 

: terminals 



1 '.rn i 

: nyip-rji 1 

i Ethernet 
interlaces 

; Einenet 

enetO 

; emt[G-3)a | 

j Parallel 

j :gPP 

ip 

i lp{ 0-7] | 

i Printer 

' YME-ICP16/8/X 

CD 

! cp[0-3] I 


4-21 


-21 


Conti citrine Your Svstem 




SECTION 5: SETTING UP YOUR NETWORK 


UNIX 4.3BSD provides support for the Defense Advanced Research Projects Agency (DARPA) standard 
internet protocols IP, ICMP, TCP, and UDP. This section tells how to connect to networks using an 
Ethernet board. 

If you are using a system shipped with an Ethernet board from Integrated Solutions, the system is already 
equipped for connection to a network. You must set up some network data bases, however, as described in 
Section 5.3. 

This section does not discuss network connections involving telephone lines. For information on uucp 
connections over a modem, see Section 3.7, "Setting Up Uucp." 

For information on the network for cluster nodes, see "Section 6: Setting Up Cluster Nodes." For 
information on the network for diskless nodes, sec "Section 7: Setting Up Diskless Nodes." 

This section contains the following subsections: 

5.1 What Is a Network? 

5.2 Configuring the Network 

5.3 Setting Up Network Data Bases 

5.4 Routing and Gateways 

5.5 Setting Up FTP 

5.6 Using TRFS (Transparent Remote File System) 

5.7 Troubleshooting the Network 


5.1 What Is a Network? 

An Ethernet board in your system lets you connect to local area networks through coaxial cables that are 
attached to other Ethernet boards. These boards are also called “controller boards,” or “controllers.” 
Through these controllers and networks you can log in to other systems and execute limited commands 
there. 

Electronic mail travels through the network, and your system can automatically forward mail if you set it 
up to do so (see Section 5.-). 

Different networks use different "protocols,” formats for exchanging electronic information. When you 
connect a system to a network, you must set up the connection for that network's protocol. In each case, 
consult the manual page for the appropriate network in Section 4 of the UNIX Programmer' s Reference 
Manual (for example, ip (4?) for Internet Protocol). 

Using Integrated Solution’s transparent remote hie system (TRES), you can access files and devices on 
selected remote systems as easily as on your own. With TRFS you need not log in to the other systems: all 
iinked remote systems operate as though they are one big system. See Section 5.6 for a further discussion 
of TRFS. 
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5.2 Configuring the Network 
Suggested reading: 

• intro (4N) *ip(4P) • inetd (8) 

• inet(4F) «tcp(4P) • ifconfig(SC) 


Configuring for a network involves starting daemons and making sure that certain files are in place. 

Use the following procedure, the Procedure to Configure the System for the Network, to configure the 
system for the network. 


Step 7. 


Step 2. 


Procedure to Configure the System for the Network 


ACTION 


WHAT IT DOES 


Check the file /ctc/rc to check that 
it includes commands to start the 
following network daemons: 

• inetd (8C) 

« rwhod(8C) 

Check the file letc/rc.local to see 
that it includes commands to start 
these network mail daemons: 

• sendmai! (8) 

• routed (8C) 


Starts the network software. These processes run 
continually in the background. 

Each command should be of the form 

letdnetdaemon ; 


Starts mail daemons at autoboot. These processes 
run continually in the background. 

The commands should be of the form 

if [ -f /etc/routed ]; then 
/etc/routed; 
fi 


Step 3. 


and 

if [ -f /usr/lib/sendmail ]; then 

(cd /usr/spool/mqueue; rm -f IP) 
/'usr/lib/sendmail -bd -qlh & 

fi 

Check the file ietclinetd.conf to see Starts site-specific network daemons. See inetd (8) 

that it contains listings for these for the format of the Ietclinetd.conf file, 

daemons: 


• comsat (SC) 

• fingerd (SC) 

• ftpd (SC) 

• hostnamed (SC) 

• rexecd (SC) 

• rlogind (8C) 

• rshd(8C) 

• telnetd (8C) 

• tf'tpd (SC) 

(continued on next page) 
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Procedure to Configure the System for the Network (continued) 

ACTION - WHAT IT DOES 

Checks for network controller configuration, 
admin (8) creates this line in /eic/rc.local during 
admin initialization. 

ifconfig(8C) enables the Ethernet controller and 
defines the network protocol. See ifconfig(SC) for 
the options, which change for each network. 


dev is the Ethernet controller: 

• n\v for the VME-ECX con 
trailer 

• ex for the Excclan controller 

• il for the Intcrlan controller 

• tty for a serial line 
N is the controller number: 

• 0 for the first controller of a 
given type, 1 for the next, 
and so on 

• the port number (ttyxx), for a 
serial line 

‘hostname*' is the word 

“hostname” in back-quotes 

Step 5. Check the /dev director, 7 for 
Ethernet files named enei[0-5]a. If 
these hies do not already exist, 
create them with the commands 

cd / dev 

MAKEDEV enetO 

Step 6. Use the procedure in Section 3.4.1, Defines 16 pseudo-terminals of type “network.” 
’’Denning Terminal Lines,” to available for network functions. The daemons need 
define 16 lines labeled ttvp [0-fj. these in order to operate with the network. 

You create the special files for these pseudo-terminal 
in the next step of this procedure. The / e:c/:tys 
entries should be • • 

ttyp [Q-~~ none network secure 

( continued cr. next pane) 


Checks for Ethernet devices for remote booting, 
admin (8) creates these devices during admin (8) 
initialization. Do this only if you want to be able to 
boot other nodes over the network. 


This example configures a host named “v24scrver” 
with a VME-ECX board, using the arp (4) protocols 
(default) and “trailer” encapsulation: 

/etc/ifconfig nwO inet ‘hostname* 

Note that with UNIX 4.3BSD, you no longer need to 
disable mailers under the arp protocols. 


Step 4. In /ctc/rc.local, check for a line 
near the top of the file, of this form: 

/etc/ifconfig dcvN inet 
‘hostname* 

all on one line, for each of your 
network controllers, where 
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Procedure to Configure the System for the Network (continued) 


ACTION 

WHAT IT DOES 

Step 7. 

Check the /dev directory for 
pseudo-terminal files named 

ttyplO-f] and ptyp[0-f]. If these 
files do not already exist, create 
them with the commands 

cd /dev 

MAKEDEV ptyO 

Creates 16 master-slave pairs of files for pseudo- 
terminals. The master file is Idevlptyp? and the slave 
is Idcvlttyp?. 

If you ever get error messages saying that you do not 
have enough plys, create 16 more with the commands 

cd /dev 

MAKEDEV ptyl 

Remember to add appropriate entries in / ctc/ttys . If 
you need more than 32 ptys, you must change the 
kernel as described in "Section 4: Configuring Your 
System." 

Step 8. 

Check the fi 1 c Isyslc onf/SYS D1ST, 
where “SYS” is one of 

. V20 for the VME-68K20 

• VI 0 for the VME-68K10 

• Q10 for the IS-68K (Q-bus) 

to see that the Ethernet driver (nw, 
ex, or il) for your system is defined. 
Remake the kernel (see Section 
4.2.3) if necessary, if you change 
this file. 

Configures the kernel for Ethernet operations. 

If the necessary drivers arc already in the kernel, this 
step is unnecessary. 

Step 9. 

Turn to "Appendix C: Config- 
uration Worksheet" and note any 
changes. 

Updates the reference sheet. 


End t 

of procedure 


£.3 Setting Up Network Data Bases 

store you proceed with this section, you should have completed the system configuration outlined in the 
revious procedure. Your system must have an Ethernet board installed, the board must be connected to a 
transceiver, and all system conn guration dies must be updated. 

Use the following procedure, the Procedure to Set Up Network Data Bases, to configure network data base 
dies. 
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Procedure to Set Up Network Data Rases 



ACTION 

WHAT IT DOES 

Step 1. 

Edit the files Ictc/hosts and 
Ictclnctworks to add local nodes or 
networks to the distributed internet 
lists. 

Modifies the data bases to include local networks that 
arc not part of the internet. 

See hosts (5) and networks (5) for entry’ formats. 
Use other entries in /clclhosts and Ictclnctworks as 
examples. 

Step 2. 

Edit the files letclhosts.equiv and 
Lrhosts to include the hostnames of 
“trusted hosts” on the network. 
Simply list the hostnames, one per 
line. 

Identifies trusted hosts for your system. People from 
these nodes, who have accounts on your system as 
well, will be able to log in and execute commands 
through the network. See rshd (8C). 

Step 3. 

Edit the file /ctc/ftpusers to deny 
ftp access to named users. This file 
should always contain the accounts 
root and uuep. 

Protects tiie system from unauthorized entry. 

ftp involves setting up a public access area for 
anonymous logins. See ftpd(8C) and Section 5.5, 
"Setting Up ftp” for advice on how to set up this area 
with restricted access. 


End of procedure 


5.4 Routing and Gateways 

When connecting to non-local networks, you must set up routing information so that the “packets” of 
information will travel correctly. A non-local network in this context means a connection between two 
servers, such as an Ethernet connection between a server for a cluster system and a server for a diskless 
system. The connection between the cluster or diskless nodes and their respective servers is considered a 
local network. 


In addition, your node may serve as a “gateway.” a conduit between two separate networks. A cluster 
server that communicates to a larger network is the gateway between the cluster network and the larger 
network. A gateway node has some special configuration considerations. 

5.4.1 Routing 

UNIX can use two methods for routing between non-local networks: 

• routed (SC), the routing daemon, can maintain the system routing tables, routed maintains up-to-date 
routing tables in a group of local area networks. Using the ietcigateways file, routed can also initialize 
static routes to distant networks. 


When routed starts up (usually from ieidrc. local), it reads the file l etc. ‘gateways and installs the routes 
defined there, then routed checks all local networks to see if they are already running a routed. If your 
routed finds another local routed, the two cooperate in maintaining a globally consistent view of 
routing in the local environment. Tnis view can extend to include remote sites also running a routed 
(see routed (SC) ). 


• You can define a “wildcard” route to a smart gateway and depend on the gateway to provide ICMP 
routing information which dynamically creates a routing data base. Define the wildcard route by 
adding an entry of the form 

/etc/route add 0 smart- gateway 1 
to ieidrz.iocal . (See route (SC) for more information.) 
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The system will use the wildcard route as a last resort in routing packets to their destinations. If the 
smart gateway successfully generates a routing message, the system then adds that route to the routing 
tables. 

This approach has some advantages over routed in that it dynamically creates a routing table entry'; 
however, the routing table entry is not dynamically modified if an alternate route for the same 
destination is available. Because of this, should a smart gateway fail there is no way to maintain 
routing service, except for manual alteration of the routing table entry. 

In an environment that contains only bridges, which do not generate routing redirect messages, route is 
not suitable. 

The system always listens to, and processes, routing table redirect information, so it is possible to combine 
both of die above facilities. You might use routed to maintain information about routes to geographically 
local networks, while using the wildcard routing techniques for distant networks. 

netstat (1) displays routing table contents as well as various routing statistics. For example, 

netstal -r 


displays the contents of the routing tables, while 
netstat -s 


shows the number of routing table entries created by the wildcard routing method described above. 
5.4.2 Gateways 


Gateway nodes handle a higher volume and wider variety of network operations than a simple network 
node. A special kernel option, GATEWAY, configures a node to be used as a gateway. This option 
increases the size of the routing hash tables in the kernel. Unless configured with that option, nodes with 
only a single non-loopback interface never attempt to forward packets or to respond with ICMP error 
messages to misdirected packets. 

This change reduces the problems that may occur when different nodes on a network disagree as to the 
network number or broadcast address. UNIX 4.3BSD machines that forward packets back through the 
same interface on which they arrived will send ICMP redirects to the source host if it is on the same 
network. This improves the interaction of gateway nodes with nodes that configure them routes via default 
gateways and redirects. The generation of redirects may be disabled with the configuration option 
IPSENDREDIRECTS=0 in environments where it may cause difficulties. 


Local area routing 
routed (SC). Gate 


within a group of interconnected Ethernets and other such networks may be handled by 
ways between the .Arpanet or Milnet and one or more local networks require an 


additional routing protocol, the Exterior Gateway Protocol (EG?), to inform the core gateways of their 



mire 


rating information from the core. If necessary, contact ISI Customer Support for 


5.5 Setting Up ftp 

Tr.e ftpd(SC) server supports an anonymous “ftp” (“file transfer protocol”) account. Because of the 
inherent security problems with such a facility, you should read this section carefully if you consider 
providing such a sendee. 

Enable the anonymous account by creating a user ftp. When a client uses the anonymous account, a 
enroot (2) system call by the sewer restricts the client from moving outside that pan of the file system 
where the user ftp home directory is located. Because of the chroot call, you must install in the ftp home 
directory certain programs and files used by the server process. Further, you must make certain that all 
directories and executable imaces are not writable. 
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The following procedure for directory setup preserves security: 
it cd "ftp 

#chmod 555 .; chown ftp chgrp ftp . 

# mkdir bin etc pub 

it chmod 555 bin etc; chown root bin etc 
it chmod 777 pub; chown ftp pub 
it cd bin 

it cp /bin/sh /bin/ls . 
it chmod 111 sh Is 

# cd Jetc 

it cp /etc/passwd /etc/group . 
it chmod 444 passwd group 

When local users wish to place files in the anonymous area, they must be placed in a subdirectory. In the 
setup here, the subdirectory is 'ftp/ pub. 

Another issue to consider is the copy of letc/passwd placed here. Users who use the anonymous account 
have read access to this file. They may then try' to break the passwords of users on your node for further 
access. A good choice of users to include in this copy of Ictc/paswd might be root, daemon, uucp, and 
the ftp user. All passwords here should probably be 

Aside from the problems of directory modes and such, the ftp server may provide a loophole for interlopers 
if certain user accounts are allowed. The file letc/fipusers is checked on each connection. If /ctc/fipuscrs 
contains the requested user name, the request for sendee is denied. This file should normally include these 
accounts: 

uucp 

root 

Accounts with nonstandard shells should be listed in this file. Accounts without passwords need not be 
listed in this file; the ftp server will not sendee these users. 


5.6 Using TRFS (Transparent Remote File System) 

The transparent remote file system (TRFS) allows you to access files on remote nodes as easily as on your 
own node. 


To use TRFS, put the string 1(5-' system-name before the pathname of files, where system-name is the 
hosmame of the node you want to access. For example, to see the contents of the /usr directory on the 
node linksystem, you would enter 

Is /@linksystem/usr 


TRFS is a transparent operation. Most UNIX commands function normally with TRFS arguments; 
need not change any existing programs or commands when using remote files through TRFS. 


VQ n 


All UNIX file protections still apply under TRFS. Assign permissions with chmod (1) as with local 


files. 


TRFS uses a special protocol designed by Integrated Solutions, Enable TRrS by including TRFS as an 
option in the kernel configuration file (isystconfiS YSJD1ST ). 

TRFS requires login accounts with the same user identifications on all linked nodes. For this reason, the 
/etc/passwd file should be the same for all nodes on a TRFS link. Tnere are two different ways of ensuring 
this: 

1. Always use admin (8) when adding or changing user accounts, and define the admin password 
administration mode as “TCP/IP.” See Section 3.3. "Initializing Your System.” This means that all 
changes to ietc/pass'vd affect all other nodes under the common password administration domain. 


o- / 


5-7 


Setting Up Your Network 



SMMrl 


System Administrator Guide 


2. Link all of the password files over TRFS with the command 
In -s l@centralhost/etc/passx\’d /etc/passwd 

where centralhosl is the main node for administration. When /etc/passwd changes, it will change on 
all nodes on the TRFS link. 


CAUTION 

When you link password files in this manner, you can no longer use 
vipw(8) to edit /etc/passwd. Use admin (8), or use vi (1 ) directly. 
When you use vi(l), the system should be in single-user mode; 
otherwise you can wreak havoc with the password file. 


Use the method from item (2), above, to link other commonly shared files and directories between nodes. 
For example, you can maintain a central library of programs on one node and link all others to that library. 
This way, when users access files in a linked directory, they do not have to know that it is on a remote 
node; the commands are the same as if the files were local. 

Linking directories and files in this manner carries two major advantages: 

• Saves disk space. The file resides on only one node. 

• Makes network-wide updates easy. When you change a linked file, it changes for all nodes on the 
TRFS link. 


5.7 Troubleshooting the Network 

When you have a network, you will occasionally experience network problems. In many cases the cause 
of network problems is simply a loose electrical connection to the network. On networks such as the 
Ethernet a loose cable tap or misplaced power cable can result in severely deteriorated service. The 
netstat (1) program can help track down hardware malfunctions. In particular, look at the -i and -5 options 
in the manual page. 

After you carefully check the physical connections to the network, look at the software. 

Check that the appropriate daemons are running in the background. Section 5.2 lists the daemon processes 
that should be running. 

Check /dev to see that these files exist: 


/dev/prypiO-f] 


/dev/ttypiO-V; 

Check the file icic/trys for proper network definitions, as described in Section 5.2. 

If you have checked the network connections, the daemon processes, and the , dev files, and the network 
still does not operate, the problem should be referred to a qualified technician. ISI Customer Support can 


provide assistance. 

Debug tools exist to help track down network problems. Most servers on the UNIX system accept a -d 
option, which forces all sockets to be created with debugging turned on. The SOJDEBUG option may be 
supplied before establishing a connection on a socket, in which case the system will trace all traffic and 
internal actions (such as timers expiring) in a circular trace buffer. You can then print this buffer with the 
trpt (SC) command. Consult the appropriate manual pages for more information. 
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SECTION 6: SETTING UP CLUSTER NODES 


This section gives procedures to set up and operate a cluster node configuration. These special 
configurations require 

• A server node (an Optimum V16 or Optimum V24 SystcmAVorkStation) 

• One or more Cluster Nodes (a set of boards with associated cables) 

• Identical UNIX release levels on the server and cluster nodes 

• Graphics software installed on the server node (if any cluster node is a graphics Workstation) 

The Optimum V Cluster Node Installation! Configuration Manual gives details on how to set up the 
hardware for a cluster node. 

This section contains the following subsections: 

6.1 What Is a Cluster Configuration? 

6.2 Directory Links for Cluster Nodes 

6.3 Configuring Cluster Nodes 

6.4 Booting Cluster Nodes 

6.5 Shutting Down Cluster Nodes 

6.6 Booting Single-User on Cluster Nodes 


6.1 What Is a Cluster Configuration? 

Section 1.2, "Introduction to Hardware," describes the physical structure of a cluster configuration. For 
system administration purposes, a cluster configuration is several nodes (individual systems) that share 
common disk resources. 


A server node operates as any normal Optimum V System or Workstation. The server node provides the 
shared disk resource. The operating system is the same UNIX 4.3BSD used for other Systems and 
Workstations. Tne kernel must contain the V3 (VMEbus backplane) driver, the RD (remote disk) driver, 
the TRFS (Transparent Remote File System) option, and the ENETFILTER option. 


Each of the cluster nodes uses files on the server node 
booted from the same UNIX kernel as the server node, 
share a common disk and a common file system. Any n' 


Each cluster node has its own CPU, possibly 
The server node and its associated cluster nodes 
e that can be accessed from the server node can 


also be accessed 


from any of the cluster nodes, subject to standard UNIX protection mechanisms. 


6.2 Directory Links for Cluster Nodes 

All cluster nodes and the server node share a common file system. VCnen you access a file from one node, 
that is the same as accessing that file from any other node. However, some files are unique to each cluster 
node, and to the server node itself. 
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The unique, node-specific files fall into two categories: 

• Configuration or data base files that contain node-specific information 

• Temporary' files and log files, where two or more processes running under different kernels might try to 
write simultaneously 

The first case includes files such as /etc/ttys, which usually are different for each node on the network. The 
second case includes the limp and lusr/tmp directories, where two processes on different kernels specify the 
same name for a temporary' file.. 

For example, programs like sort (1) create temporary files to hold the sorted information. These files are 
created in the lusr/tmp directory and have a name of the form lusr/tmplstm$$, where $$ is expanded to 
represent the current process ID. 

In single-processor systems, attaching the process ID to the temporary file name prevents collisions 
between concurrent sons because all process IDs arc unique On a cluster network, two processes with the 
same ID might exist, which would create one temporary file rather than two separate temporary files. 
Therefore, separate processors must have separate temporary' areas. 

The UNIX kernel solves this problem by providing naming conventions for node-specific files and 
directories. The naming convention is based on the node hostname. The kernel provides unique names by 
expanding, or translating certain string variables when it evaluates the targets of symbolic links: 

• $HOST translates to the hostname of the node from which the request originates, server or remote. 

• SRHOST translates to the hostname of the remote node from which the request originates. If the 
request originates on the server node, SRIIOST translates to a null string. 

• SREMOTE translates to the string remote when interpreted on a remote node, and to a null string on 
the server node. 

• SMACHINE translates to one of the following: 

— Q10 for an Optimum (Q-bus) system 

— V10 for an Optimum V system with a VME-6SK10 CPU board 

— V20 for an Optimum V system with a VME-68K20 CPU board 

As an example, consider a symbolic link to the file test.SRHOST. When a command is issued on the server 
node that refers to this sy'mbolic link, it tries to access a file “test ." . A command issued from a cluster 
node named cwsl tries to access a file “ iesi.cwsr\ 

Tnrough symbolic links, this process is transparent to the user. A file or directory name such as ieichtys is 
actually a symbolic link to a file or directory name which has one of the siring variables embedded. The 
kernel expands the string and accesses the correct file for the requesting node. 

For example, the following command links the directory amp tc a directory name with the embedded 
string: 

In -s /.tmpASRHOST /tmp 

(Note the backslash (\) precedes the dollar sign (S), which “escapes,” or prevents shell interpretation.) On 
a network with a server node named centra! and cluster workstation nodes cwsl and cws2. a pathname that 
includes limp will translate to 
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• (on central) l.tmp. 

• (on cwsl) l.tmp.cwsl 

• (on c\vs2) I.tmp.cws2 

Each of these l.tmp directories then contains files specific to its related node. The user simply types / tmp in 
pathnames; the kernel handles the interpretation invisibly. 

Specifying a file by its real name (for example, tele Limp. cwsl) will always access that particular file. 

When the admin (8) program configures a cluster network it makes node-specific links for these files and 
directories: 


• Idcv 

• Ictclfstab 

• I clcl mo id 

• Ictclpsdaiabasc 

• Ictclrc 

• Ictclrc.local 


• Ictclttys 

• leiclutmp 

• I tmp 

• lusrladm 

• lusr/liblcrontab 


• lusr/lib/mail 

• lusrlspoollmqueue 

• lusr/spool/rwho 

• lusrhmp 

• Ivmunix 


Check your own UNIX installation for local programs that use temporary or log files. If any programs use 
temporary' or log files in areas other than those listed above, and these programs can run on more than one 
processor simultaneously, you must create a symbolic link either for the files or for the directory in which 
they reside. 

When you create node-specific symbolic links, you might want to make the “real” file or directory names 
begin with a period: 

/tmp ~> /. tmp.SRHOST 

Tnis way, the casual user will see only the link and not be confused by a profusion of names like 

I imp. cwsl 
Itmp.cws2 
hmp.cwsS . . . 

since the Ls (1) command does not normally show filenames that begin with a period (.). 


6.3 Configuring Cluster Nodes 

Configuring a cluster network involves four tasks: 


1. Arranging for swap space. 

2. Choosing a network address for the server node, whi 
3.3, "Initializing Your System." 


:h should already be done as shown in Section 


Choosinz a name for each cluster node. 


4. Configuring the network with admin (8). 


6.3.1 Allowing Swap Space for Cluster Nodes 

Cluster nodes require swap space on the server node. The server node uses assigned disk partitions for 
swap space; the cluster nodes, having no disks of their own. use files for swap space. 

Cluster nodes use a file iusrlsp o olidiskl err mam e . swap on the server node, where “name” is the hostname 
of the cluster node, admin (8; creates the swap directory when configuring cluster nodes. 
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These files can be very large, up to 16.5 Mbytes apiece (16,500 Kbytes, as measured by the Is (1) and df (1) 
commands). When you configure the file systems for your network, you must allow enough space for these 
files in the lusr partition. 

Normally, the files are not that large. To see the actual size of the files, enter the command 
Is -s /usr/spool/diskIess/*.swap 

The -s option to Is shows the size in blocks of the files. Do not use the -1 option to look at file size; this 
gives a character count, an inaccurate measure in this case. 

Enter the command 

df 

to see current disk usage. Check the “available” (avail) column for the lusr file system. There should be 
at least 5000 Kbytes available for each cluster node on the network. Section 4.3, "Configuring Disks," tells 
you how to change disk configuration if you need to assign a larger partition for swap files. You can also 
create a "spanned disk" and use partitions from several disks to create a very large (or simply more 
efficient) file system for the swap file area. 

If the lusr file system is not large enough to hold the swap files, you can either use a symbolic link to put 
the swap files in another file system or create a spanned disk to enlarge the file system. For example, the 
command 

In -s /diskless/usr/spool/diskless /usr/spool/diskless 

points to a directory in another area, a /diskless file system that you can create with the newfs (8) command 
as described in Section 4.3.4, "Adding a New File System." Mount (mount (8)) this file system on a 
sufficiently large disk partition. 


6.3.2 Choosing Names and Addresses for a Cluster Network 

When you configure a cluster network, you assign a network address for the server node; admin (8) 
automatically creates addresses for cluster nodes based on this server address. 

If you have not already done so, complete the procedure in Section 3.3, "Initializing Your System." This 
procedure assigns a name and internet address for the server node. You must complete this naming 
procedure before installing cluster or diskless nodes. 

Choose hostnames for each of the cluster nodes and write them down. Use hostnames with less than 
twelve characters. Do not use spaces within hostnames; use underscores to separate words (for example, 
cn_name). The hostnames must be unique within the network. 

In "Appendix C: Configuration Worksheet," In the area reserved for networks, enter this information: 

• Server node's hostname 

• Hostname of each cluster node 

Tne procedure in Section 6.3.3, "Configuring the Network With admin (8),” will assign network addresses 
for the cluster nodes. Enter this information in Appendix C when you run the procedure. 
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6.3.3 Configuring the Network With admin (8) 

Use the following Procedure to Add a Cluster Node to the Network to configure the cluster network or to 
add a cluster node to an existing network. 


Procedure to Add a Cluster Node to the Network 



ACTION 


WHAT IT DOES 

Step 1. 

If you have not yet done 

so, 

Sets up the server for cluster operations. See Section 


configure the server node 
admin (8). 

with 

3.3, "Initializing Your System." 

Step 2. 

Enter the command 
/etc/admin 


Invokes the administration program. 

Step 3. 

Select option C at the top menu of 
the admin (8) program. 

Selects operations dealing with local (diskless or 
cluster) networks. 

Step 4. 

Select option II from the 
menu. 

next 

Selects adding a cluster node to the network, admin 
now prompts for the name of the cluster node, and 
whether or not this is a graphics node. See Table 6-1 
for further details on admin operations. 



End of procedure 
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Table 6-1. admin Adding a Cluster Node 


What admin (8) Does 

Affected Files 

Prints the top-level menu. Select item C, “Diskless/Cluster installation 
and deletion.” 

— 

Prints the disklcss/clustcr menu. Select item B, “Add a cluster node.” 

— 

Prompts for the name of the cluster node. Enter a name, with the same 
restrictions on length and characters as for the server node name. 

— 

Prompts for graphics configuration of the cluster node. If this is a 
Cluster Workstation (graphics), answer y; if this is a Cluster Compute 
Node (non-graphics), answer n. 


Prints the cluster node name and internet address, formatted as for the 
file lad hosts. You should write this information in "Appendix C: 
Configuration Worksheet." 

admin chooses an internet address for this cluster node, admin 
chooses a unique address, based on the internet address for the vbO 
VMEbus backplane network controller on the server node. 

If you accept the information printed by admin, press <retum> to 
continue the procedure. If you want to abort admin, press ~C (CTRL- 
C) to prevent any changes to system files. 


Writes the cluster node name and internet address to Ictclhosts. 

Ictclhosts 

Creates the swap directory lusrl spool! diskless, if it does not already 
exist. 

1 usrl spool! diskless 

Creates various “hidden” files and directories for the cluster node. 
See Section 6.2, "Directory Links for Cluster Nodes." 

. 

Idcv 

letc/fstab 

letc/motd 

ietclpsdaiabasc 

letclrc 

letc/rc.local 

/etc! ttys 

letc/utmp 

/trap 

lusr/adm 

lusr/libl crontab 

/usr/lib/mail 

1 us r I spool imp ueue 

lusrl spool rwho j 

lusritmp 

ivmunix j 
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6.4 Booting Cluster Nodes 

Boot the server node as any other Optimum V System or Workstation using the procedures in "Section 2: 
Starting UNIX from Disk." Once the server node is running, bool the cluster nodes one at a time. 

Booting a Cluster Workstation (a graphics node) requires graphics software on the server node. If the 
server is a Workstation, this software is already in place. Graphics software is on the standard ISI UNIX 
4.2/3BSD release tape from Release 3.05 onward. Contact ISI Customer Support if you do not have the 
necessary graphics software. 

Use the following procedure, the Procedure to Boot a Cluster Node, to boot a cluster node. Figure 6-1 
shows a sample of a normal cluster node boot. 


Procedure to Boot a Cluster Node 



ACTION 

WHAT IT DOES 

Step 7. 

Boot the server node, if it is not yet 
running. Continue the bool to 
multiuser UNIX. 

You cannot boot cluster nodes without a functioning 
server node. Booting the server node also provides 
power to the cluster nodes. 

Use the procedures in "Section 2: Starting UNIX 
from Disk" to boot the server node. 

Step 2. 

Check that the server node has files 
of the name 

/dev/enct[0-3]a 

Checks for /dev files to support remote booting. 
These files must exist in the Idev directory. 

If they are not there, create them with the procedure 
in Section 4.6, "Malting New Devices in /dev." 

Step 3. 

Enter the command 
ps -aux | grep bootd 

Checks that the boot daemon, / etc/bootd . is running 
in the background. If it is not, enter the command 

/etc/bootd & 

and check that the file /etc/rc.local to sec that it has a 
command to start the daemon. 

Step 4. 

Enter the command 

ps -aux | grep 5 @-name ’ 

where name is the hostname of the 
cluster node you want to boot, and 
’( a'- name ’ is enclosed by single 
quotes (apostrophes). 

Cheeks for leftover processes from the last boot of 
this cluster node. You cannot boot if these processes 
exist. See Section 6.5, "Shutting Down Cluster 
Nodes," to remove these processes. 

Tnese processes occur on server nodes that service 
requests from cluster nodes. They execute entirely in 
kernel mode, with no associated user. 

Step 5. 

Turn on power for the cluster 
node's console (or monitor if the 
cluster node is a Workstation). 

Powers up the console (monitor). 

Step 6. 

Press R.ETURN* on the console 
keyboard. Wait for the PROM 
prompt (:). 

Displays the PROM prompt for the cluster node. 
You can now enter commands to the cluster node's 
CPU PROMS. 


( continued 

on next pace) 
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Step 7. 


Step S. 


Step 9. 



Procedure to Boot a Cluster Node (continued) 

ACTION WHAT IT DOES 


Enter the character (SHIFT-2 
on most terminals) and press 
RETURN. 


Boots the cluster node through the VMEbus 
backplane driver (vb) from the server node’s disk. 

After a successful boot, the console shows the 
single-user UNIX prompt (#). 

If the boot docs not work, you can boot 

manually from the PROMs. Enter the command 

vb(0,0 )scrvcr:kcrncl HOST=hostnamc 
SERVER=server 


all on one line, where 

server is the hostname of the server node. Note 
that this appears twice in the boot string. 

kernel is the name of the kernel for booting. This 
is usually /vmunix. 

hostname is the hostname of this cluster node. 

For example, this command boots a cluster node 
named cwsl from a server named v24: 

vb(0,0)v24:/vmunix HOST=c\vsl SERVER=v24 


Enter the command 

date yymmddhhmm 

where yymmddhhmm is today’s 
date. 


Tells UNIX what time it is. See date(l) for details 
on the entry format. 


Enter a ~D (CTRL-D; hold down Boots to multiuser UNIX using the shell script 
the CTRL key and press D). ietc/.rc.locai.name, where name is the hosmame of 

the cluster node. 

After displaying several messages, the monitor shows 
this prompt: 

IS68K 4.3 BSD ( hostname ) 
login: 

where hostname is. the hosmame of this node, Tnis is 
the UNIX login prompt. 

Logs in to UNIX, giving access to a working C shell 
(UNIX command processor). You can now issue 
UNIX commands to the shell prompt (#). 

Note that a Cluster Workstation (graphics node) 
requires graphics software on the server node. See 
the comment at the beginning of this subsection. 

End of procedure 


Lou in as the superuser bv entering 
root as your iogin name. 

The root password is the same for 
all nodes on the local cluster 
network: you must use the same 
password as for the server node. 
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You cannot turn off power to a cluster node without also turning off power to the server node, and vice 
versa. Therefore, if you want to leave the server node operating, you can only bring the cluster node down 
to a PROM prompt and urn off the console (or Workstation monitor). 

The shutdown procedure differs depending on your current condition: 

• If you arc running multiuser UNIX, begin with Step 1 in the following procedure. 

• If you are running single-user UNIX (the command line shows tire single-user prompt (#)), skip to Step 
2 of the following procedure. 

• If the cluster node has crashed, skip to Step 4 of the following procedure before rebooting. 

Use tlie following procedure, die Procedure to Shut Down a Cluster Node, to shut down a cluster node. 


Procedure to Shut Down a Cluster Node 



ACTION 

WHAT IT DOES 

Step 7. 

Enter litis command: 
shutdown +n 

where n is a time in minutes. 

Notifies users of shutdown, waits for die specified 
ume, and then kills all processes. When shutdown is 
complete, the monitor shows the single-user prompt 

00. 

CAUTION 

If you turn off your system at this 
point, you risk losing data. You 
must finish all steps of this 
procedure. 

Step 2. 

Enter the command 
reboot 

Updates the superbiock and brings the cluster node to 
the PROM prompt (:). 

Wait until the PROM prompt (:) appears. 

Step 3. 

Turn OFF power for the cluster 
console (or Workstation monitor). 

Powers down the console for this node. The cluster 
node is now “off,” though the CPU is still active. 

Step 4. 

At the server node, enter the 
command 

ps -aux | grep '(a-name' 

where name is the hesmame of the 
cluster node you just shut down, 
and '(cp-namc' is enclosed by single 
cuotes (apostrophes). 

Displays all processes running on the server node that 
are associated with the cluster node. These processes 
are now useless, and will interfere with any efforts to 
reboot the cluster node. 

If this command shows no processes on lie server 
node you are now finished with this procedure. 

Step 5. 

Enter the command 
killpg -9 pid 

where pid is any one of the process 
IDs displayed in Step 4. 

Kills the named process and all other processes in the 
process group. See killpg (S; for more details on this 
command. 


End of procedure 
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Initialize all memory 
Cluster Node 1 

(Integrated Solutions logo appears here) 

Integrated Solutions 

VMEBUS 68020 4.4/1 boot: Wed Apr 22 19:15:44 PDT 1987 
327872+39808+108684 start 0x800 

Integrated Solutions UNIX Release 4.0 til (rool@ UNKNOWN) Wed Apr 1 16:58:26 PST 1987 

real memory = 2.00M 

available memory = 1.1 1M 

detached memory = 0.1 2M at 0x1 C0000 

using 90 buffers containing 0.1 7M of memory 

VB0 at address 0xf00000/074000000 ** no vector 

vbO at VB0 slave 0 (60.123.0.0.0.0) 0.50M @ OxfOOOOO 

root on rdOa, dump on rdOb, args on rdOb, swap on rdle 

16.67 MC68020 CPU 
Parity Enabled 

*** WARNING: should run interleaved swap with >= 2 Mb *** 

U 

rr 


Figure 6-1. Sample of a Normal Cluster Node Boot 


6.5 Shutting Down Cluster Nodes 

To shut down a cluster network, first shut down the individual cluster nodes, then shut down the server 
node with the procedure in Section 2.4, "Shutting Down the System." 

CAUTION 

Failure to shut down the system in an orderly fashion may result in lost 
data. In particular, simply turning off power without an orderly 
shutdown will probably result in data loss. 
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Table 6-3. Moving Between UNIX Modes on Cluster Nodes 


Want: 

PROM 

Single-User UNIX 

Multiuser UNIX 
system-name # 
(or $, %, login:) 

Now: 

: 

# 

PROM 


Enter the character 

Follow the procedure in 

l 


as described in Section 

Section 6.4, "Booting 



6.4, "Booting Cluster 
Nodes." If this does not 
work, use the command 

vb(0,0 )server.kerncl 
HOST -ho st name 
SERVER=server 

all on one line, as 
described in the same 
section. 

Cluster Nodes." 

Single-User 

UNIX 

Enter 


Enter a 'D (CTRL-D; hold 
down Uie CTRL kev and 

# 

# reboot 

Wait for the PROM 
prompt to appear. 

CAUTION 

Pushing RESET crashes 
all nodes in the cabinet 
down to their PROM 
prompts, but this can write 
bad data to the server 
node’s disks, even with a 
sync (8) first. Always run 
fsck (8) on the server node 
after a RESET. 


press D) to force a quick 
switch to multiuser. 

For a full reboot, enter the 
comman: 

reboot 

and boot from the PROM 
prompt as described above 
in this table. 

Multiuser 

Use the procedure in 

Use the shutdown (8) 


UNIX 

Section 6.5, "Shutting 

command as described in 


system-name tt 

Down Cluster Nodes," 

Section 6.5, "Shutting 


or S 

until the PROM prompt 

Down Cluster Nodes." 


or 9; 

appears (after Step 2). 

This informs others of the 


or login: i 

See CAUTION above. 

shutdown, sends warning 

i 

1 

messages, then boots 


I 

j 

down to single-user. 

j 
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6.6 Booting Single-User on Cluster Nodes 

Cluster nodes use the same UNIX modes as normal Systems or Workstations. Boot the cluster node to 
multiuser UNIX for normal operation. Other modes are useful for 

• Issuing PROM commands (Section 6.6.1) 

• Running diagnostics (Section 6.6.2) 

Table 6-2 shows the UNIX' modes and their purposes. 


Table 6-2. UNIX Operation Modes for Cluster Nodes 


UE3B3M 

Mode 

Purpose 


PROM 

Communicating with the bootstrap PROMs on the 
CPU (see Section 1.2) for 

• booting UNIX (Section 6.4) 

• using PROM commands (Section 6.6.1) 

• stand-alone diagnostics (Section 6.6.2) 

# 

Single-user 

UNIX 

Issuing commands as root with no other users logged 
in. Useful for changing hardware configurations. 

system-name # 
or $ 
or % 
or login: 

Multiuser 

UNIX 

Multiuser UNIX operation. This is the normal mode 
for the system; normal booting tries to reach this 
level. 


Table 6-3 shows how to move from any mode to any other mode. Find the mode you are in and read 
across to the column for the mode you want. 
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6.6.1 Using Commands at the Cluster Node PROM Prompt 

The PROM prompt (:) gives access to the CPU PROMs. At this prompt you can use the commands in 
Table 6-4. 


Table 6-4. Commands at the Cluster Node PROM Prompt 


Command 

What It Does 

@ 

Boots the cluster node to single-user UNIX, using the kernel 
l.vmunix.SHOST on the server node. 

» 

Toggles interrupt enabling by die monitor. Entering ! enables 
interrupts; entering ! again disables them. 

vb(0, m)sourcc:filcnamc 

i 

1 

| 

! 

i 

i 

! 

j 

1 

! 

; i 

: ! 

1 

Loads and starts execution of a file on a device, where 

vb is the VMEbus backplane driver, which actually accesses the 
boot disk on the server node. Commands at a cluster node 
PROM prompt can access only the boot disk. 

m is the device “minor” number, the partition number on the 
boot disk. 

source is the hostname of die node where the desired kernel 
resides. 

filename is the path to the file you want to execute on disk. 

For example, you could issue this command; 

vb(0,0)v24server:stand/V20/mmu 

to execute the file lstand/V20immu on the a (first, numbered from 
zero) partition of the boot disk on a server node named v24server. 

If you want to go directly to a block instead of a partition, you can 
specify a number followed by “b”. For example, 

sd(0.10b) 

In some applications, it may be desirable to load a program without 
automatically beginning its execution. Preceding the load string 
with “<” causes the file to be loaded and a starting address to be 
printed. Then control is returned to the PROM monitor. The ; 
program can then be started by typing a “> tollowee by the j 
specified starting address. 

•' r n r • » r v p nr r r\n np • 
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Table 6-4. Commands at the Cluster Node PROM Prompt ( continued ) 


Command 

What It Does 

% address [value] 

Opens/modifies location as a byte where address is the hexadecimal 
address for that memory location and [value] is the optional new 
hexadecimal value to write at address. 

$ address [value] 

Opens/modifics location as a word where address is the 
hexadecimal address for that memory location and [value] is the 
optional new hexadecimal value to write at address. 

# address [value] 

Opcns/modifies location as a longword where address is the 
hexadecimal address for that memory location and [value] is the 
optional new hexadecimal value to write at address. 


You can use these commands in two ways: 
by entering the address in hex 


$fff520 


or by entering the address in hex with a new value for that 
address 


$fff5 20 123456 


If you specify the value, the location is written to without ever 
being read. 


When you type % and the hexadecimal address of a memory 
location, the system appends a vertical bar (1) followed by the 
current byte value at that address and waits for you to enter the 
hexadecimal address of the new location. 


When you type S and the hexadecimal address of a memory j 
location, the system appends a colon (:) followed by the current j 
word value at that address and waits for you to enter the 
hexadecimal address of the new location. I 


When you type # and the hexadecimal address of a memory j 
location, the system appends a semi-colon (;) followed by the 
current word value at that address and waits for you to enter the j 
hexadecimal address of the new location. j 

i 

i 

For example, entering j 


S200 

i 

! 

might display 

i 

i 

200:6SAC_ 

i 

where ’ T _" represents the cursor location. : 

j 

1 

If you do not t\pe in a new value and you press RETURN, the ! 

location remains unmodified. i 

j 

( continued on next page) ! 
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Table 6-4. Commands at the Cluster Node PROM Prompt (continued) 


Command 

What It Docs 


If you type in a new hex value following the displayed hex value 
200:68AC 68AF 

and press RETURN, the new value is written to the current 
location, and the colon (:) prompt appears. 

If you type in a new hex value following the displayed value 

200:68AC 68AF 

and press LINE FEED, the new value is written to the current 
location and die next location is opened, rather dian returning to die 
PROM monitor prompt (:). 

If you type in a new hex value following the displayed value and 
follow it with a backslash (\), 

200:6SAC 68AF\ 

the new value is written to the current location and the previous 
location is opened, radicr dian returning to the PROM monitor 
prompt (:). 

Opening a non-existent memory location with interrupts enabled 
will cause the system to continuously attempt to access die non- 
existent location, causing trap errors. 

> address 

i 

I ! 

1 ! 

i 

! 

Begins execution at a hex address. 

If you enter the ’’greater than" sign (>) and an address in hex, 
execution immediately begins at that address. For example, 
entering 

>6SAC 

begins execution at 6SAC. | 

1 

{ 

i 

i 

Puts the CPU into transparent mode. Characters from the console ( 
are transmitted to the second serial port and characters from the ! 
second serial port are directed to the console port. j 

' Exits transparent mode and returns you to the PROM monitor i 
Drorrm (V) ■ 
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6.6.2 Running Diagnostics on Cluster Nodes 

Two hardware diagnostic programs are useful for cluster nodes: 

1. mmu to test the Memory Management Unit on the CPU 

2. mem to lest main memory 

Use these diagnostic programs only if you suspect hardware failures. For example, run diagnostics in 
response to these symptoms: 

• Cluster node will not boot 

• Cluster node crashes frequently 

Since cluster nodes cannot execute programs from a tape drive, you must install the diagnostic programs on 
the server node’s boot disk. Sec Section B.2.2, "Running Diagnostics From UNIX," for instructions to 
install diagnostic programs on the server node. 

Use the following Procedure to Load Diagnostics on a Cluster Node to run hardware diagnostics. 


Cluster Nodes 
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Procedure to Load Diagnostics on a Cluster Node 



ACTION 

WHAT IT DOES 

Step 1. 

Check that the monitor displays the 
PROM prompt (:). 

Checks for the right mode for diagnostics. 

Step 2. 

Enter this command: 

Loads the program and begins execution. For 


vb(0,0)jcrver:stand/S'} , S//ei-/ 

example, to execute the mmu test enter 


where 

vb(0,0)v24server:stand/V20/mmu 


vb is the VMEbus backplane 
driver, which actually accesses 
the boot disk on the server node. 

where v24server is the hostname of the server node. 
This cluster node has a VME-68K20 CPU board. 
The (0,0) refers to the first partition of the first disk 
(numbered from 0, remember), also known as 


server is the hostname of the 

partition a, holding the root (/) file system. 


server node 

The console should now display this message: 


SYS is your system type (CPU 
type): 

Type RETURN to start at 0 xwww 


. V20 for the VME-68K20 

If the command does not work, check that the 
directory Island on the server node contains 


• VIOforthc VME-6SK10 

diagnostic programs. If the directories lstand/V20 , 


. Q10 for the IS-68K (Q-bus) 

Istand/VlO , and Istand/QlO do not exist, you must 
install them from the diagnostic tape. See Section 


test is the diagnostic test, either 

B.2.2, "Running Diagnostics From UNIX." 


• mmu or 



• mem 


Step 3. 

Press RETURN. 

Starts the test. 

Step 4. 

Follow the instructions in 

Runs the diagnostic test. The tests themselves are 


"Appendix B: Using Diagnostic 

identical in procedure to those run on the server node 


Programs" to execute the diag- 

or any other node. 


nostic test. See either 



Section 3.3. "Using mmu" or 



Section B.4, "Using mem" 



End of 

procedure 
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SECTION 7: SETTING UP DISKLESS NODES 


This section gives procedures to set up and operate a diskless node configuration. These special 
configurations require 

• At least one server system (any Optimum System, Optimum V System, or Optimum V Workstation) 
with an Integrated Solutions VME-ECX Ethernet controller or an Excclan Ethernet controller (Intcrlan 
will not work) 

• One or more Diskless Nodes (special systems with an Ethernet controller and no disk drives) 

• Identical UNIX release levels on the server and diskless nodes 

• Graphics software installed on the server node (if any diskless node is a graphics Workstation) 

The Optimum V Diskless Node Installation/Configuration Manual gives details on how to set up the 
hardware of a diskless node. 

This section contains the following subsections: 

7.1 What Is a Diskless Configuration? 

7.2 Directory Links for Diskless Nodes 

7.3 Configuring Diskless Nodes 

7.4 Booting Diskless Nodes 

7.5 Shutting Down Diskless Nodes 

7.6 Booting Single-User on Diskless Nodes 


7.1 What Is a Diskless Configuration? 


Section 1.2, "Introduction to Plardware," describes the physical structure of a diskless configuration. For 
system administration purposes, a diskless configuration is several nodes (individual systems) sharing 
common disk resources. 


A serve: node operates as any normal Optimum or Optimum V system. The operating system is the same 
UNIX 4.3BSD used for other Systems and Workstations. The kernel must contain the NW (Integrated 
Solutions Ethernet) or EX (Exc elan Ethernet) driver, the RD (remote disk) driver, the TRFS (Transparent' 
Remote File System) option, and the ENE7FIL7ER option. 

Each of the diskless nodes uses files on the server node. Each diskless nods has its own CPU, booted from 
a UNIX kernel on the server node. The server node and its associated diskless nodes share a common disk 
and a common file system. Any file that can be accessed from fine server node can also be accessed from 
any of the diskless nodes, subject to standard UNIX protection mechanisms. 

A single network can accommodate several server nodes. Tne boot procedure in Section 7.4, "Booting 
Diskless Nodes," describes how to specify a particular server node when booting a diskless node. 


7.2 Directory Links for Diskless Nodes 


All diskless nodes and the server node share a common file system, 
that is the same as accessing that file from any other node. Howeve 
node, and to the server node itself. 


When you access a file from one node. 
:, some files are unique to each diskless 
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The unique, node-specific files fall into two categories: 

• Configuration or data base files that contain node-specific information 

• Temporary files and log files, where two or more processes running under different kernels might try to 
write simultaneously 

The first case includes files such as Ictc/ttys, which usually arc different for each node on the network. The 
second case includes die Itmp and /usr/tmp directories, where two processes on different kernels specify the 
same name for a temporary file. . 

For example, programs like sort(l) create temporary files to hold the sorted information. These files are 
created in the /usr/tmp directory and have a name of the form lusrltmp/stm$$, where $$ is expanded to 
represent the current process ID. 

In single-processor systems, attaching the process ID to the temporary file name prevents collisions 
between concurrent sorts because all process IDs arc unique. On a diskless server’s file system, two 
processes with the same ID might exist, which would create one temporary file rather than two separate 
temporary' files. Therefore, separate processors must have separate temporary areas. 

The UNIX kernel solves this problem by providing naming conventions for node-specific files and 
directories. The naming convention is based on the node hostname. The kernel provides unique names by 
expanding, or translating certain string variables when it evaluates the targets of symbolic links: 

• SHOST translates to the hostname of the node from which the request originates, server or remote. 

• SRHOST translates to the hostname of the remote node from which the request originates. If the 
request originates on the server node, SRHOST translates to a null string. 

• SREMOTE translates to the string remote when interpreted on a remote node, and to a null string on 
the server node. 


• SMACHINE translates to one of the following: 

— Q10 for an Optimum (Q-bus) system 

— V10 for an Optimum V system with a VME-6SK10 CPU board 

— V20 for an Optimum V system with a VME-6SK20 CPU board 

As an example, consider a symbolic link to the file test. SRHOST. When a command is issued on the server 
node that refers to this symbolic link, it tries to access a file “ test .”. A command issued from a diskless 
node named dwsl tries to access a file “ test. dwsl ' ’. 


inrough symbolic links, this process is transparent to the user. A file or directory name such as /etc! ttys is 
actually a symbolic link to a file or director}’ name which has one of the string variables embedded. The 


kernel exrands the serin z and 


:sses me ccrr; 


1- .V. 

ic iO. ui; 


rcestme no; 


ror example, the following command links the director}’ itmp to a director}- name with the 


In -s /.tmp.lSRHOST /tmp 

(Note the backslash (\) precedes the dollar sign (S), which “escapes,” or prevents shell interpretation.) On 
a network with a server node named central and diskless nodes dwsl and dws2, a pathname that includes 
imp will translate to 


i-l 
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• (on central) Ltmp. 

• (on dwsl) Ltmp. dwsl 

• (on dws2) Ltmp.dws2 

Each of Uiese Limp directories then contains files specific to its related node. The user simply types /tmp in 
pathnames; the kernel handles the interpretation invisibly. 

Specifying a file by its full name (for example, Icicl Amp. dwsl) will always access that particular file. 

When the admin (8) program configures a server node for a diskless network, it makes node-specific links 
for these files and directories: 


• /dev 

• Ictclfstab 

• /etc/mold 

• Ictc/psdaiabasc 

• letc/rc 

• tadre. local 


• letclltys 

• Ictclutmp 

• limp 

• lusr/adm 

• lusr/lib/crontab 


• lusrllib/mail 

• lusr/spoollmqueue 

• lusr/spool/rwho 

• lusrhmp 

• Ivmunix 


Check your own UNIX installation for local programs that use temporary or log files. If any programs use 
temporary or log files in areas other than those listed above, and these programs can run on more than one 
processor simultaneously, you must create a symbolic link cither for the files or for the directory in which 
they reside. 

When you create node-specific symbolic links, you might want to make the “real” file or directory names 
begin with a period: 

/tmp ~> /.tmp.SRHOST 

This way, the casual user will sec only the link and not be confused by a profusion of names like 

ltmp. dwsl 
I tmp. dwsl 
itmp.dwsS . . . 

since the Ls (1) command does not normally show filenames that begin with a period (.). 


7.3 Configuring Diskless Nodes 

Configuring a diskless network involves four tasks: 

2. Choosing a network address for the server node, which shoul 
2.3, "Initializing Your System." 

5. Choosing a name and network address for each diskless node. 
4. Configuring the network with admin (8). 


aov oe cone as snow- in > cation 


7.3.1 Allowing Swap Space for Diskless Nodes 

Diskless nodes reouire swap space on the server node. The server node uses assigned disk partitions for 
swap space: the diskless nodes, having no disks of their own, use files for swap space. 

Diskless nodes use a file lusri spool/ diskless inane .srwap on the sewer node, where “name” is the hostname 
of the diskless node, admin (S) creates the swap directory when configuring diskless nodes. 
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These files can be very large, up to 16.5 Mbytes apiece (16,500 Kbytes, as measured by the Is (1) and df (1) 
commands). When you configure the file systems for your network, you must allow enough space for these 
files in the /usr partition. 

Normally, the files are not that large. To see the actual size of the files, enter the command 
Is -s /usr/spool/diskIess/*.swap 

The -s option to Is shows the size in blocks of the files. Do not use the -1 option to look at file size; this 
gives a character count, an inaccurate measure in this case. 

Enter the command 

df 

to see current disk usage. Check the “available” (avail) column for the /usr file system. There should be 
at least 5000 Kbytes available for each diskless node on the network. Section 4.3, "Configuring Disks," 
tells you how to change disk configuration if you need to assign a larger partition for swap files. You can 
also create a "spanned disk" and use partitions from several disks to create a very large (or simply more 
efficient) file system for the swap file area. 

If the /usr file system is not large enough to hold the swap files, you can either use a symbolic link to put 
the swap files in another file system or create a spanned disk to enlarge the file system. For example, the 
command 

In -s /diskless/usr/spool/diskless /usr/spool/diskless 

points to a directory in another area, a /diskless file system that you can create with the newfs (8) command 
as described in Section 4.3.4, "Adding a New File System." Mount (mount (8)) this file system on a 
sufficiently large disk partition. 


7.3.2 Choosing Names and Addresses for a Diskless Network 

When you configure a diskless network, you assign a network address for the server node during admin (8) 
initialization. Then, when adding each diskless node to the network, you must provide an internet address 
for the diskless node. 


If you have not already done so, complete the procedure in Section 3.3, "Initializing Your System." This 
procedure assigns a name and internet address for the server node. You must complete this naming 
procedure before installing diskless nodes. 


Choose hostnames for each of the diskless nodes and write them down. Use hostnames with less 
twelve characters. Do not use spaces within hostnames: use underscores to separate words (for exarr 
dl_name'i. Tne hostnames must be unique within the network. 



Choose an interne 
hostnames: look in 


t aaciress tor mis diskless 
this hie for examples of inte 


:ode. i'ne file i etc/ ho sis defines internet addresses 
iet addresses. Network addresses have this format: 


r..r..r..r. 


where each n is a decimal number 1-255. 

Tne first of the four numbers in an internet address is the “network number.” You should use tne same 
network number as the Ethernet controller of the server node. 

In "Appendix C: Configuration Worksheet," in the area reserved for networks, enter this information: 


• Server node's hostname and internet address 

• Hostname and internet address of each diskless node 
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7.3.3 Configuring the Network With admin (8) 


Use the following Procedure to Add a Diskless Node to the Network to configure the diskless network or to 
add a diskless node to an existing network. 

Procedure to Add a Diskless Node to the Network 


ACTION 

WHAT IT DOES 

Step 1. 

If you have not yet done so, 
configure the server node with 
admin (8). 

Sets up the server for diskless operations. See 
Section 3.3, "Initializing Your System." 

Step 2. 

Enter die command 
/etc/admin 

Invokes the administration program. 

Step 3. 

Select option C at the top menu of 
the admin (8) program. 

Selects operations dealing with local (diskless or 
cluster) networks. 

Step 4. 

Select option A from the next 
menu. 

Selects adding a diskless node to the network, 
admin now prompts for the name and internet 


address of the diskless node, and whether or not this 
is a graphics node. See Table 7-1 for further details 
on admin operations. 


End of procedure 


'O 
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Table 7-1. admin Adding a Diskless Node 


What admin (8) Does 

Affected Files 

Prints the top-level menu. Select item C, “Diskless/Cluster installation 
and deletion.” 

— 

Prints the diskless/cluster menu. Select item A, “Add a diskless 
node.” 

' — 

Prompts for the name of the diskless node. Enter a name, with the 
same restrictions on length and characters as for the server node name. 

— 

Prompts for the internet address of the diskless node. See Section 
7.3.2, "Choosing Names and Addresses for a Diskless Network," to 
determine an internet address. 


Prompts for graphics configuration of the diskless node. If this is a 
Diskless WorkS union (graphics), answer y; if this is a Diskless 
Compute Node (non-graphics), answer n. 


Prints the diskless node name and internet address, formatted as for the 
file /ctc/hosls. You should write this information in "Appendix C: 
Configuration Worksheet." 


If you accept the information printed by admin, press <rctum> to 
continue the procedure. If you want to abort admin, press X (CTRL- 
C) to prevent any changes to system files. 


Writes the diskless node name and internet address to /etc/ frosts. 

/etc/hosts 

{ Creates the swap directory lusr! spool! diskless, if it does not already 
1 exist. 

lusr/spool/diskless 

| Creates various “hidden” files and directories for the diskless node, 
j See Section 7.2, "Directory Links for Diskless Nodes." 

! 

i 

/ dev 

/etc/fstab 

/etc/motd 

letclpsdaiabasc 

/etc/rc 

/etclrc.local 

/etc/ttys 

ictc/ump 

limp 

Insr/adm 
hisriiib/crontab 
iusr /lib/ mail 

. i 

iusr. spootimqueue j 
iusr! spool >rwho j 

iusr ;im.n 

j 
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7.4 footing Diskless Nodes 

Boot the server node as any other Optimum or Optimum V system using the procedures in "Section 2: 
Shirting UNIX from Disk." Once the server node is running, boot the diskless nodes one at a time. 

Booting a Diskless Workstation (a graphics node) requires graphics software on the server node. If the 
server is a Workstation, this software is already in place. Graphics software is on the standard ISI UNIX 
4.2/3BSD release tape from Release 3.05 onward. Contact ISI Customer Support if you do not have the 
necessary software release. 

Use the following procedure, the Procedure to Boot a Diskless Node, to boot a diskless node. Figure 7-1 
shows a sample of a normal diskless node boot. 


Procedure to Boot a Diskless Node 



ACTION 

WHAT IT DOES 

Step 1. 

Boot the server node, if it is not yet 
running. Continue die boot to 
multiuser UNIX. 

You cannot bool diskless nodes without a functioning 
server node. 

Use the procedures in "Section 2: Starting UNIX 
from Disk" to boot the server node. 

Step 2. 

Check that the server node has files 
of the name 

ldcvlenel[0-3]a 

Checks for Idcv files to support remote booting. 
These files must exist in the /dev directory. 

If they are not there, create them with the procedure 
in Section 4.6, "Making New Devices in /dev." 

Step S. 

Enter the command 
ps -aux i grep bootd 

Cheeks that the boot daemon, / etc! bootd , is running 
in the background. If it is not, enter the command 

/etc/bootd & 

and check that the file /etc/rc. local to see that it has a 
command to start the daemon. 

Step 4. 

Enter the command 

ps -aux | grep , (a, -name' 

where name is the hostname of the 
diskless node you want to boot, and 
'(d'-name' is enclosed by single 
quotes (apostrophes). 

Checks for leftover processes from the last boot of 
this diskless node. You cannot boot if these 
processes exist. See Section 7.5, "Shutting Down 
Diskless Nodes," to remove these processes. 

These processes occur on server nodes that sendee 
requests from diskless nodes. They execute entirely 
in kernel mode, with no associated user. 

Step S. 

Turn on power for the diskless 
node’s console (or monitor if the 
diskless node is a WorkSrau _r.;. 

Powers up the console (monitor). 

Step 6. 

-•mess ?w i URN on the console 
keyboard. Wait for the PROM 
rromo: c). 

Displays the PROM prompt for the diskless node. 
You can now enter commands to the diskless node's 
CPU PROMS. 


i continued on next paset 
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Procedure to Boot a Diskless Node ( continued ) 

ACTION WHAT IT DOES 

Boots the diskless node through the Ethernet driver 
(ex or nw) from the server node’s disk. 

After a successful bool, the console shows the 
single-user UNIX prompt (#). 

The command broadcasts a request from the 
diskless node over the Ethernet; any server node on 
the network that is configured to support this diskless 
node can respond. If two or more servers respond, 
the first to respond becomes the server for this 
diskless node. 

If the boot does not work, or if you want to 

name a specific server node, you can boot manually 
from the PROMs. Enter the command 

dev(0,0)kernelhost:kcrnel HOST = ho si name 
SERVER =scrvcr 

all on one line, where 

dev is the Ethernet controller on the diskless node, 
either 

• nw for the VME-ECX board, or 

• ex for the Excelan Ethernet board 

kernelhost is the node from which you want to use 
the specified kernel. Note that this is usually, but 
not necessarily, the same hostname as server. 

kernel is the name of the kernel for booting. This 
is usually vmunix. 

hosiname is the hostname of this diskless node. 

server is the hostname of the server node. 

For example, this command boots a diskless node 
named dwsl, with a VME-ECX Ethernet controller, 
from a server node named central: 


Step 7. Enter the character (SHIFT-2 
on most terminals) and press 
RETURN. 


nw{0,0)centra!: / '‘m , jnix HOST=dwsl SERVER=cenrraI 

Step S. Enter the command 

date yynvnddkkrrjK 

where yymmddhhmm is today’s 
date. 

(continued or. rex: page) 


tells UNIX what time it is. Sec date(l) for details 
on the entrv format 
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Procedure to Boot a Diskless Node (continued) 


ACTION 

WHAT IT DOES 

Step 9. 

Enter a A D (CTRL-D; hold down 
the CTRL key and press D). 

Boots to multiuser UNIX using the shell script 
leicl.rc. local. name, where name is the hostname of 
the diskless node. 

After displaying several messages, the monitor shows 
this prompt: 

IS68K 4.3 BSD ( hostname ) 
login: 

where hostname is the hostname of this node. This is 
the UNIX login prompt. 

Step 10. 

Log in as the superuser by entering 
root as your login name. 

The root password is the same for 
all nodes on the local diskless 
network; you must use the same 
password as for the server node. 

Logs in to UNIX, giving access to a working C shell 
(UNIX command processor). You can now issue 
UNIX commands to the shell prompt (#). 

Note that a Diskless Workstation (graphics node) 
requires graphics software on the server node. See 
the comment at the beginning of this subsection. 


End of procedure 


Initialize all memory . . 

(Integrated Solutions logo appears here) 

Integrated Solutions 

VMEBUS 6S020 4.4/1 boot: Wed Apr 22 19:15:44 PDT 1987 
:(S_ 

327872-r39S0S-rl0S5S- start 0x800 

Integrated Solutions UNIX Release 4.0 #1 (root@ UNKNOWN) Wed Apr 1 16:58:26 PST 1987 
real mem = 2.00M 
avail mem = 1.26M 

detached memory = 0.12M at OxleOOOO 
using 84 buffers containing G.17M of memory 


Figure 7-1. Sample of a Normal Diskless Node Boot 


EXO at address 0xff0000/C77600000 vector 0x50/0120 
exO at EXO slave 0 (S. 0.20.3 2. 1.1 03) HW 0.0 NX - 

root on smOa. dump on smOb. args on smOb, swap on smOb 


16.67 MC6S020 CPU 
Parity enabled 

WARNING: should ran interleaved swan with >= 2 Mb 
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7.5 Shutting Down Diskless Nodes 

To shut down a diskless network, first shut down the individual diskless nodes, then shut down the server 
node with the procedure in Section 2.4, "Shutting Down the System." 

CAUTION 

Failure to shut down the system in an orderly fashion may result in lost 
data. In particular, simply turning off power without an orderly 
shutdown will probably result in data loss. 

The shutdown procedure differs depending on your current condition: 

• If you are running multiuser UNIX, begin with Step 1 in the following procedure. 

• If you arc running single-user UNIX (the command line shows the single-user prompt (#)), skip to Step 
2 of the following procedure. 

• If the diskless node has crashed, skip to Step 4 of the following procedure before rebooting. 

Use the following procedure, the Procedure to Shut Down a Diskless Node, to shut down a diskless node. 


Procedure to Shut Down a Diskless Node 



ACTION 

WHAT IT DOES 

Step 1. 

Enter this command: 
shutdown +n 

where- n is a time in minutes. 

Notifies users of shutdown, waits for the specified 
time, and then kills all processes. When shutdown is 
complete, the monitor shows the single-user prompt 

(#)• 

CAUTION 

If you turn off your system at this point, 
you risk losing data. You must finish .11 
steps of this procedure. 

Step 2. 

Enter the command 
reboot 

Updates the superblock and brings the diskless node 
to the PROM prompt (:). 

Wait until the PROM prompt (:) appears. 

Step 3. 

Turn OFF power for the diskless 
node. 

Removes power from the diskless node. The diskless 
node is now off. 

Turn off power for the- console (or Workstation 
monitor! as %- ell. 


( cor.tiKu.ee 

or. next page, 1 
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Procedure to Shut Down a Diskless Node (continued) 



ACTION 

WHAT IT DOES 

Step 4. 

At the server node, enter the 
command 

ps -aux | grep '@-name' 

where name is the hostname of the 
diskless node you just shut down, 
and ’ @-namc ’ is enclosed by single 
quotes (apostrophes). 

Displays all processes running on the server node that 
are associated with the diskless node. These 
processes arc now useless, and will interfere with any 
efforts to reboot the diskless node. 

If this command shows no processes on the server 
node you are now finished with this procedure. 

Step 5. 

Enter the command 
killpg -9 pid 

where pid is any one of the process 
IDs displayed in Step 4. 

Kills the named process and all other processes in tire 
process group. Sec killpg (8) for more details on this 
command. 

End of procedure 

7.6 Bootin 

g Single-User on Diskless Nodes 



Diskless nodes use the same UNIX modes as normal Systems or Workstations. Boot the diskless node to 
multiuser UNIX for normal operation. Other modes are useful for 

• Issuing PROM commands (Section 7.6.1) 

• Running diagnostics (Section 7.6.2) 

Table 7-2 shows the UNIX modes and their purposes. 


Table 7-2. UNIX Operation Modes for Diskless Nodes 


i Prompt 

Mode 

Puroose 

1 •' 

PROM 

Communicating with the UNIX bootstrap PROMs on 
the CPU (see Section 1.2) for 

1 


• booting UNIX (Section 7.4) 

* using PROM commands (Section 7.6.1) 



• stand-alone diagnostics (Section 7.6.2) 

- 

S in ole- user 
UNIX 

Issuing commands as root with no other users logged 
in. Useful for changing hardware configurations. 

or S 
or Cc 
or login: 

UNIX 

Multiuser UNIX operation. This is the normal mode 
for the system: normal booting tries to reach this 
level. 


table 7-3 shows how to move from any mode to any other mode. Find the mode you are in and read 
across to the column for the mode vou want. 
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Table 7-3. Moving Between UNIX Modes on Diskless Nodes 


Want: 

PROM 

Single-User UNIX 

Multiuser UNIX 
system-name # 
(or $, %, login:) 

Now: 


# 

PROM 


Enter the character 

Follow the procedure in 



as described in Section 
7.4, "Booting Diskless 
Nodes." If this does not 
work, or if you want to 
name a specific server 
node, use the command 

dev((),0)kcrnelhost:kerncl 
HOST -hostname 
SERVER=server 

all on one line, as 
described in the same 
section. 

Section 7.4, "Booting 
Diskless Nodes." 

Single-User 

UNIX 

# 

Enter 
it reboot 


Enter a 'D (CTRL-D; hold 
down the CTRL key and 
press D) to force a quick 


Wait for the PROM 
prompt to appear. 

CAUTION 

Pushing RESET can crash 
the system down to the 
PROM prompt, but this 
can write bad data to the 
server node’s disks, even 


switch to multiuser. 

For a full reboot, enter the 
command 

reboot 

and boot from the PROM 
prompt as described above 
in this table. 


with a sync (8) first. 




Always run fsck (8) on the 
server node after a 
RESET. 



Multiuser 

Use the procedure in j 

Use the shutdown (S) 

i 

UNIX 

Section 7.5, "Shutting j 

command as described in 

1 

sy stem-name ~ 1 

Down Diskless Nodes," ! 

Sect:;?. 7.5, "Shuttir.tr 

j 

or S j! 

until the PROM prompt j 

Down Diskless Nodes.” i 


or Dr j; 

appears (after Step 2). ! 

Tnis informs others of the ; 


or login: 

See CAUTION above. j 

shutdown, sends warning 
messages. then boots 
down to sincle-user. I 
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7.6.1 Using Commands at the Diskless Node PROM Prompt 

The PROM prompt (:) gives access to the CPU PROMs. At this prompt you can use the commands in 
Table 74. 


Table 7-4. Commands at the Diskless Node PROM Prompt 


Command 

What It Does 

@ 

Boots the diskless node to single-user UNIX, using the kernel 
l.vmunix.$HOST on the server node. 


The “<3>” command broadcasts a request from the diskless node 
over the Ethernet; any server node on the network that is configured 
to support this diskless node can respond. If two or more servers 
respond, the first to respond becomes the server for this diskless 
node. 

j 

Toggles interrupt enabling. Entering ! enables monitor interrupts; 
entering ! again disables them. 

dcv(()pn)sourcc:fdcnaine 

Loads and starts execution of a file on a device, where 


dev is cither 

• n\v for the VME-ECX Ethernet board, or 

• ex for the Excelan Ethernet board 


which actually accesses the boot disk on the server node. 
Commands at a diskless node PROM prompt can access only the 
boot disk. 

m is the device “minor” number, the partition number on the 
boot disk. 

source is the hostname of the node where the desired kernel 
resides. 

fderuzme is the path to the file you want to execute on disk. 

For example, you could issue this command: 


n\v(0,0)v24server:stand/V20/mmu 


I to execute the file isiand'VZOjmrr.u on the 
: zero) partition of the boo: disk on a server 
with a VME-ECX Ethernet controller. 


a (first, numbered from 
node named v24server 


If you wan: to go directly to a block instead’ of a partition, you can 
; specify a number followed by “b”. For example, ' * 

sd(0.I0b't : 

; In some applications, it may be. desirable to load a program without j 
automatically beginning its execution. Preceding the load string j 
! with “<” causes the file to be loaded and a starting address to be j 
’ printed. Tnen control is returned to the PROM monitor. The j 
| program can then be started by typing a “>” followed by me [ 
j specified scartinz address. 

( cominued or. rex: pose) I 
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Table 7-4. 

Commands at the Diskless Node PROM Prompt ( continued ) 

Command 

What It Does 

% address lvalue] 

Opens/modifies location as a byte where address is the hexadecimal 
address for that memory' location and [value] is the optional new 
hexadecimal value to write at address. 

$ address [value] 

Opens/modifies location as a word where address is the 
hexadecimal address for that memory location and [value] is the 
optional new hexadecimal value to write at address. 

# address [value] 

Opens/modifies location as a longword where address is the 
hexadecimal address for that memory' location and [value] is the 
optional new hexadecimal value to write at address. 


You can use these commands in two ways: 
by entering the address in hex 


$fl‘f520 


or by entering the address in hex with a new value for that 
address 


$fff520 123456 


If you specify the value, the location is written to without ever 
being read. 

i 

When you type % and the hexadecimal address of a memory 
location, the system appends a bar (1) followed by the current byte 
value at that address and waits for you to enter the hexadecimal 
value of the new location. 

1 

1 

When you type S and the hexadecimal address of a memory 
location, the system appends a colon (:) followed by the current 
word value at that address and waits for you to enter the 
hexadecimal value of the new location. j 


1 

When you type # and the hexadecimal address of a memory' 
location, the system appends a semi-colon (;) followed by the 
current word value at that address and waits for you to enter the ; 

hexadecimal value of the new location. j 

1 


For example, entering 


; s2oo i 

! i 

: might display 

| 200:6SAC_ I 

j i 

| where "_y represents the cursor location. i 

I i 

) It you do not type in a new value and you press ?>_=. 1 URN, the ; 

| location remains unmodified. j 

( continued on next uasc ) 
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Table 7-4. Commands at the Diskless Node PROM Prompt (continued) 


Command 

What It Does 


If you type in a new hex value following the displayed hex value 
200:6SAC 68AF 

and press RETURN, the new value is written in the current 
location, and the colon (:) prompt appears. 

. If you type in a new hex value following the displayed value 

200:68AC 68AF 

and press LINE FEED, the new value is written to the current 
location and the next location is opened, rather than returning to the 
PROM prompt (:). 

If you type in a new hex value following the displayed value and 
follow it with a backslash (\), 

290:68AC 68AF\ 

the new value is written to the current location and die previous 
location is opened, rather than returning to the PROM prompt (:). 

Opening a non-existent memory location with interrupts enabled 
will cause the system to continuously attempt to access the non- 
existent location, causing trap errors. 

> address 

Begins execution at a hex address. 

If you enter the "greater than" sign (>) and an address in hex, you 
will immediately begin execution at that address. For example, j 
entering ! 

>6SAC 

begins execution at 6SAC. i 

i 

| 

Puts the CPU into transparent mode. Characters from the console 
are transmitted to the second serial port and characters from the 
second serial port are directed to the console port. 

i 

Exits transparent mode and returns to the monitor prompt (:). 

— 

Sends one tilde (~) to the transparent side. ! 
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7.6.2 Running Diagnostics on Diskless Nodes 

Two hardware diagnostic programs are useful for diskless nodes: 

1. mmu to test the Memory Management Unit on the CPU 

2. mem to test main memory 

Use these diagnostic programs only if you suspect hardware failures. For example, run diagnostics in 
response to these symptoms: 

• Diskless node will not boot 

• Diskless node crashes frequently 

Since diskless nodes cannot execute programs from a tape drive, you must install the diagnostic programs 
on the server node's boot disk (or on die bool disk of any diskless server node on the local network). See 
Section B.2.2, "Running Diagnostics From UNIX," for instructions to install diagnostic programs on the 
server node. 

Use the following Procedure to Load Diagnostics on a Diskless Node to run hardware diagnostics. 
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Procedure to Load Diag 

nostics on a Diskless Node 


ACTION 

WHAT IT DOES 

Step 1. 

Check that the monitor displays the 
PROM prompt (:). 

Checks for die right mode for diagnostics. 


Step 2. Enter tliis command: 

d£v(0,0)xerver:stand/M7S//e.rt 
where 
dev is either 


Loads the program and begins execution. For 
example, to execute the mrnu test through a VME- 
ECX Ethernet controller, on a diskless node with a 
VME-68K20 CPU board, enter 

nw(0,0)v24server:stand/V20/mmu 


. n\v for the VME-ECX 
Ethernet board, or 

• ex for tiie Excelan Etlicmct 
board 

which actually accesses the boot 
disk on the server node. 

server is the hostname of the 
node where the desired test 
resides. 

SYS is your system type (CPU 

type): 

. V20 for the VME-6SK20 


where v24server is the hostname of the server node. 
This diskless node has a VME-6SK20 CPU board. 
The (0,0) refers to the first partition of die first disk 
(numbered from 0, remember), also known as 
partition a , holding die root (/) file system. 

The console should now display diis message: . 

Type RETURN to start at Oxiwiv 

If die command docs not work, check that the 
director}' Island on the server node contains 
diagnostic programs. If the directories lstand/V20 , 
IstandIVIO , and IstandlQlO do not exist, you must 
install them from the diagnostic tape. See Section 
B.2.2, "Running Diagnostics From UNIX ’ 


. V10 for the VME-68K10 


. Q10 for the IS-6SK (Q-bus) 
test is the diagnostic test, either 
• mmu or 


• mem 


5 tep S. Press R_ i URN. Stans the test. 


Step 4. 

Follow the 
"Appendix B: 
Programs" to 
ncstic test. See 

instructions in Runs the diagnostic test. The tests themselves are 

Using Diagnostic identical in procedure to those run on the server node 

execute the diag- or any other node, 

either 


Section 37. " 

Usingmmu" or 


Section B.-."" 

Using mem" 

End cf procedure 
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SECTION 8: DAY-TO-DAY OPERATIONS 


This section gives procedures for daily operation and maintenance of the UNIX system. 

This section contains the following subsections: 

8.1 What Is UNIX Maintenance? 

8.2 Recovering From Crashes 

8.3 When Do You Boot Single-User? 

8.4 Using Commands at the PROM Prompt 

8.5 Monitoring Your System 

8.6 Accounting 

8.7 Backing Up Your System 

8.1 What Is UNIX Maintenance? 

After booting the system and setting it up, the System Administrator’s daily duties include: 

• Troubleshooting — fixing problems such as system crashes and corrupted file systems 

• Monitoring — checking various parts of UNIX to make sure that everything is running well 

• Accounting — keeping track of users, malting sure that they follow any rules for this site (such as disk 
quotas) 

• Backing up — copying disk contents onto tape for safe storage, and restoring files from these backup 
tapes 


8.2 Recovering From Crashes 

If the system crashes, it will ordinarily reboot automatically to multiuser operation. If the boot halts and 


gives the single-user prompt (#), try entering reboot for a fresh start. If the boot halts and gives the PROM 
prompt (:), use the procedure in Section 2.3, "Booting the System." 


Use fsck ($) to clean up the disks after a crash: see Section 2.6, "What to Do if the Autoboot rails." 


If a cluster node crashes, see Section 6.5. "Shuttinc Down Cluster Nodes." If 


rasnci, s; 


Under some circumstances you may 
single-user UNIX prompt (~) or a: 


want to interrupt the autoboot in order to execute cor 
the PROM prompt (:). For example, the diagnostic 


Appendix B require the PROM prompt. See Section 8.3 for single-user and PROM boots. 

If the system crashes ana prints a terse hardware diagnostic message on the system consol: 
diagnostic message in the UNIX Programmer’ s Reference Manual (PRM), Section 4. For e 
message 


nmanas <2.1 utc 
: programs in 

e, look up the 
.xample, if the 


sdr.: lost interrupt, 
appears, look a: sd (4). 
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UNIX saves these hardware diagnostic messages in a file / usr/adm/messages . See Appendix B for 
diagnostic programs to correct hardware errors. 

When the system crashes voluntarily it prints on the console a message of the form 
panic: message 

UNIX dumps a core image then triggers an automatic reboot, as described in "Section 2: Starting UNIX 
From Disk." If fsck (8) finds no faults, the system resumes multiuser operation. 

One common cause of a panic crash is hardware failure. Table 8-1 shows some common panic crash 
messages with explanations. 


Table 8-1. Panic Crash Messages 


Crash Message 

What It Means 

panic: 10 err in push 
hard 10 err in swap 

The system encountered an error trying to write to 
the paging device, or an error in reading critical 
information from a disk drive. Fix the disk if it is 
broken or unreliable. 

panic: timeout table overflow 

The timeout table ran out of entries. A minor 
problem; rebooting usually fixes it. 

panic: trap type n 
where n is a number 0-13 

The system encountered an unexpected trap. The 
trap types arc 

0 Reset 7 TRAPV instruction 

2 Bus error 8 Privilege violation 

3 Address error 9 Trace 

4 Illegal instruction 10 Line 1010 emulation 

5 Zero divide 11 Line 1111 emulation 

6 CHK instruction 

panic: init died 

The system initialization program, init (8), has died, | 
so no new users can log in. Rebooting is the only j 
repair for this, so the system reboots. S 
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8.3 When Do You Boot Single-User? 

The system can operate in three modes, each with a different prompt. Table 8-2 shows these modes. For 
cluster nodes see Section 6.6, "Booting Single-User on Cluster Nodes." For diskless nodes see Section 7.6, 
"Booling Single-User on Diskless Nodes." 


Table 8-2. UNIX Operation Modes 


Prompt 

Mode 

Purpose 


PROM 

Communicating with the UNIX boot- 
strap PROMs on the CPU (sec Section 
1.2) for 

• installing UNIX from tape 
(Appendix A) 

• booting UNIX (Section 2) 

• stand-alone diagnostics (Appendix 
B) 

• using PROM commands (Section 
8.4) 

# 

Single-user 

UNIX 

Issuing commands as root wilh no 
other users logged in. Useful for 

• mounting and unmounting file 
systems (mount (8)) 

• checking the disks (fsck (S)) 

• backing up the file systems 
(Section 8.7) 

• changing hardware configurations I 

(Section 4.5) ! 

; Sr stem-name ~ ■ 
| or S ! 

or % 
or login: 

Multiuser 

UNIX 

Multiuser UNIX operation. This is the j 
normal mede for the system; 
autobooting tries to reach this level. 


Boo: to the single-use: UNIX prompt (#) to have the system to yourself. In this mode, no one else can log 
in. This is particularly useful for commands (fsek (S), umount (8), etc.) that require an inactive nle system. 

Boo: to the PROM prompt (:} to use the stand-alone diagnostics in Appendix 3. or to boot UNIX from 
some kernel source other than vmur.ix (al-v(O.O )vmunb: to the PROM prompt). 

You can also use the PROM prompt to issue commands in Section 8.4, "Using Commands at the PROM 


table S-3 shows how to move from any mode to any other mode. Find the mode you are in and read 
across to the column for the mode vou want. 
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Table 8-3, Moving Between UNIX Modes 


Want: 

PROM 

Single-User UNIX 
# 

Multiuser UNIX 
system-name # 
(or $, %, login:) 

Now: 

PROM 

> 

Enter 

: <&v( 0 , 0 )vmunix 

where dev is the name of 
the system’s boot disk. 

Enter the character 

for a full autoboot. Or 
shortcut by booling to 
single-user (sec this table) 
and from single-user to 
multiuser (see this table). 

CAUTION 

This method bypasses disk 
checks; do this only after a 
graceful shutdown. 

Single-User 

UNIX 

# 

j i 

Enter 

#umount -a; reboot 

Wait for the PROM 
prompt to appear. After 
ten seconds with no entry, 
the system will autoboot. 

CAUTION 

Pushing RESET can crash 
the system down to the 
PROM prompt, but this 
can thrash the disks, even 
with a sync ( 8 ) first. 
.Always run fsck ( 8 ) after a 
RESET. 


Enter 
# reboot 

to perform a full reboot. 

Entering a ~D (CTRL-D; 
hold down the CTRL key 
and press D) forces a 
quick switch to multiuser. 

CAUTION 

This method bypasses disk 
checks; do this only after a 
graceful shutdown. 

i Multiuser 
UNIX 

sv stem-name ~ 

o'r s 1 

r- 

cr 7 c • 

or login: 

Use the procedure in 
Section 2.4, "Shutting 
Down the System," until 
the PROM prompt appears 
(after Step 2). j 

See CAUTION above. 

j 

j 

Use the shutdown (8) 
command as described in 
Section 2.4, "Shutting 
Down the System." This 
informs others of the 
shutdown, sends warning 
messages, then boots 
down to single-user. ; 

j 

i 

j 
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8.4 Using Commands at the PROM Prompt 

The PROM prompt (:) gives access to the CPU PROMs. At this prompt you can use the commands in 
Table 8-4. For PROM commands on cluster nodes, see Section 6.6, "Booting Single-User on Cluster 
Nodes." For PROM commands on diskless nodes, see Section 7.6, "Booting Single-User on Diskless 
Nodes." 


Table 8-4. Commands at the PROM Prompt 


Command 

What It Docs 

@ 

Boots the system to multiuser UNIX, using the kernel Ivmunix on 
the default boot disk drive. 

t 

Toggles interrupt enabling. Entering ! enables interrupts; entering ! 
again disables. 


dev(M,m)filcnamc 


Loads and starts execution of a file on a device, where 


dev is die device name (e.g., sd, ts) 


M is the device number (e.g., 0 for the first such device, 1 for the 
second) 

m is the device “minor” number, usually 


• for disks, the partition number 

• for tapes, the file number on the tape 

filename is the path to the file you want to execute on disk. There 
is no filename when you specify a tape device. 

For example, you could issue these commands: 

ts(O.S) 

sd{().6)stand/badl44 

1 to execute the eighth file cn a tape or to execute the file 
| standlbadl44 on the s (7th, numbered from zero) partition of an SD 
; disk. 

i 

If you want to go directly to a block instead of a partition, you can 
specify a number followed by “b”. For example, 

I sd(0.10b) 



(cominued on r.cx: page, 
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Table 8-4. Commands at the PROM Prompt (continued) 


Command 

What It Does 

% address [value] 

Opens/modifies location as a byte where address is the hexadecimal 
address for that memory location and [value] is the optional new 
hexadecimal value to write at address. Table 8-5 shows memory 
locations for Optimum V system board addresses. Tabic 8-6 shows 
memory locations for Optimum system board addresses. 

S address [value] 

Opcns/modifies location as a word where address is the 
hexadecimal address for that memory location and [value] is the 
optional new hexadecimal value to write at address. 

It address [value] 

Opcns/modifies location as a longword where address is the 
hexadecimal address for that memory location and [value] is the 
optional new hexadecimal value to write at address. 


You can use these commands in two ways: 
by entering the address in hex 


$fff*520 


or by entering the address in hex with a new value for that 
address 


Sfff520 123456 


If you specify the value, the location is written to without ever 
being read. 


When you type % and the hexadecimal address of a memory 
location, the system appends a bar (1) followed by the current byte 
value at that address and waits for you to enter the hexadecimal 
value of the new location. 

! 

When you type S and the hexadecimal address of a memory j 
location, the system appends a colon (:) followed by the current J 
word value at that address and waits for you to enter the 
hexadecimal value of the new location. 

I 

When you type # and the hexadecimal address of a memory 
location, the system appends a semi-colon (;) followed by the ! 
current word value at that address and waits for you to enter the j 
hexadecimal value of the new location. ! 




michi display 


| 

j 

200:68AC_ 


| 

where repr 

esents the cursor location. 

1 

If you do not 

type in a new value and you press RETURN, the 


location remains unmodified. 

(con 

Inued on next page) 
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Table 8-4. Commands at the PROM Prompt (continued) 


Command 

What It Does 


If you type in a new hex value following the displayed hex value 
200:68AC 68AF 

and press RETURN, the new value is written to the current 
location, and the colon (:) prompt appears. 

•If you type in a new hex value following the displayed value 

200:68AC 68AF 

and press LINE FEED, the new value is written to die current 
location and die next location is opened, rather than returning to die 
PROM prompt (:). 

If you type in a new hex value following the displayed value and 
follow it with a backslash (\), 

200:68AC 68AF\ 

the new value is written to the current location and the previous 
locauon is opened, rather than reluming to the PROM prompt (:). 

Opening a non-existent memory location with interrupts enabled 
will cause the system to continuously attempt to access the non- 
existent location, causing trap errors. 

> address 

Begins execution at a hex address. 

If you enter the "greater than” sign (>) and an address in hex, 
execution begins immediately at that address. For example, 
entering 

>68 AC 

execution begins immediately at 6SAC. 

~ j 

Puts the CPU into transparent mode. Characters from the console 
are transmitted to the second serial port and characters from the j 
second serial port are directed to the console port. j 

; Exits transparent mode and returns to the monitor prompt. i 

— ^enas one tilde {~ i to me transparent side. 
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Table 8-5. Optimum V System Board Addresses in Memory^ 


Function 

Device 

Board 

Default 

Alternate 

Tape 

ts 

VME-QIC2/R' 

fff550 

fff520 

Disk 

sd 

VME-SCSI 

ffffeO 

fffffO 


sm 

VME-SMD 

0 in short 
I/O space 

0200, 0400, 0600 

Serial 

Ports 

cp 

VME-ICP16/X 

fff520 

fff560, fff580, fff5a0, fff5c0 

Ethernet 


Excelan 

VME-ECX 

ffOOOO 

180000 

fe0000,ff0100, feOlOO 

Other 

fiP 

Graphics — GIP^ 
Graphics — Display 
Memory'^ 


ff8000, ff4000, ffOOOO, fecOOO 
dOOOOO, cOOOOO, bOOOOO, aOOOOO 


sky 

VME-FFP 

ffSIOO 

ff81 10, ff8 1 20, ff8 1 30, ffR140 


Table 8-6. Optimum System Board Addresses in Memory^ 


Function 

Device 

Board 

Default 

Alternate 

Tape 

ts 

IS-QIC2 

3ff550 

3ff520 

Disk 

cl 

RL101 


3ff910 


hp 

RL101 


3ffcc0 


rx 

RX02 

3ffe78 

3ffc68 

Serial 

Pons 

dh 

ISDH 

3fe010 

3fe020, 3fe030, 3fe040, 3fe050, 
3fe060, 3fe070, 3feOSO 


dm 

ISDH 

3ffl40 

3ff 148, 3ffl 50, 3ff 1 58, 3ff 1 6>. 
3ffl6S, 3ffl 70, 3ffl7S 


dl 

ISDH 

(DL emulation) 

3ffd40 

3ffd48, 3ffd50. 3ffd58, 3ffd' ' . 
3ffd6S, 3ffd70. 3ffd78 


ciz 

ISDZ 

3fe008 

3fe010, 3fe018, 3fe020, 3fe02S. 
3fe030. 3fe03S. 3fe040 ' 

Ethernet 

ex 

Excelan 

3feS00 

3fe810, 3feS20, 3feS30 


il 

Interlan 


3fe810, 3fe820 


Ip 

ISLP 

3fff4c 


■ ■ 

sky ; 

IS-FFP 

3fe2S0 

i 


AH memory addresses are hexadecimal numbers. On Optimum V systems with 6S010 CPUs memory addresses 
instead o: 

Addresses lor GI? and Display Memory are matched pair:. 
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8.5 Monitoring Your System 

Table 8-7 shows the tasks to perform at various intervals. 


Table 8-7. Maintenance Tasks 


Interval 

Task 

Why 

Daily 

dump w 

Shows the file systems that should be dumped, 
dump (8) uses fstab(5) and Icicldumpdatcs to keep 
track of this. 



See Section 8.7, "Backing Up Your System," for a 
more thorough system of daily backups (the “Towers 
of Hanoi” schedule). 

Weekly 

df 

df(l) shows the current capacity of each file system. 
Check that none are getting too full. For a cluster or 
diskless network, check that the lusr file system has 
enough room for swap files. 


quot 

quot (8) checks the amount of disk space taken up by 
each user. Use this command only when using 
system accounting (see Section 8.6, "Accounting"). 


fsck -p 

Checks the file systems for trash. Boot down to 
single-user to do this (see Section 8.3). If fsck shows 
problems, run fsck manually (see Section 2.6). 


Is -rt /tmp 

Check the limp director}' with Is -rt and remove any 
ancient files that are just taking up disk space. 
Autobooting does this automatically. 

I 

i 

i 

i 

1 

dump lun 

Runs a “level 1” dump(S) of the selected file 
system (see Section 8.7). This saves all files changed 
since the last level 1 dump. Do this for all tile 
systems. i 

Monthly j 

dump Oun 

Runs a level 0 dump(S) of the selected file system j 
(see Section 8.7). Do this for all file systems. 


uuclean 

Cleans the lusr! spool luucp area. 
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8.5.1 Monitoring System Files 

Table 8-8 shows system files that require periodic attention or that contain definitions specific to your site. 


Table 8-8. Files to Be Maintained 


File 

Function 

/ctclfstab 

how disk partitions arc used 

/etc/disklab 

disk partition sizes 

/ctc/sptab 

spanned-disk configurations 

leiclprinicap 

printer data base 

letclgeltylab 

terminal type definitions 

/ctc/rcmote 

hostnames and phone numbers of remote systems for tip(l) 

Ictc/group 

group memberships 

/etc/motd 

message of the day 

fctclpasswd 

password file; each account has a line 

/ctc/rc.local 

local system restart script; runs reboot; starts daemons 

/etc/hosts 

hostname data base 

letclnetworks 

network name data base 

/etc/services 

network services data base 

/ctclhosts.cquiv 

“trusted’’ hosts for remote logins 

l.rhosts 

“trusted” hosts for remote root access 

Ictclhost.lpd 

hosts with remote access to local printers 

letclttys 

defines terminal lines 

lusr/libi'croniab 

commands that are run periodically 

lusrllibimaili aliases 

mail forwarding and distribution groups 

/usr/adm/acct 

raw process account data 

iusriadm! messages 

system error log 

iusricdmlshuidowndog 

log of system reboots 

lusriadm/wtmp 

login session accounting 


8.5.2 Monitoring for Performance 

In addition to the regimen in Table 8-7. you can monitor the system’s activity with an eye to improving 
performance. 

Use the vmstat (1) and ps (1) commands to show CPU and memory activity. Ideally, there should be 

• few blocked (b) jobs 

• little paging or swapping activity 

• available bandwidth on disks 


• high user CPU use (us) 

If the system is busy, then the count of active jobs may be large, and several of these jobs may often be 
blocked (b). If the virtual memory is active, then the paging daemon will be running (sr will be non-zero'!. 
It is healthy for the paging daemon to free pages when the virtual memory gets active; it is triggered by the 
amount of free memory dropping below a threshold and increases its pace as free memory goes to zero. 

Running vmstat (1) when the system is busy (type vmstat 1 for a running display of everything) can show 
imbalances by noting abnormal job distributions. If many processes are blocked (b), then the disk 
subsystem is overloaded or unbalanced. If several non-DMA devices or open teletype lines are “ringing." 
or user programs are doing high-speed non-buffereo input/output, then the system time may be high (60-70 
percent or higher 
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You can often pin down the cause of high system time by checking for excessive context switching (cs), 
interrupt activity (in), or system call activity (sy). Large systems may average about 60 context switches 
and interrupts per second and about 90 system calls per second. 

If the system has a heavy load, or if you have little memory for your load (2M is little in most any case), 
then the system may be forced to page/swap. This causes a noticeable reduction in system performance 
and lengthy pauses (sometimes more than 5 seconds) when interactive jobs such as editors swap out. If 
you expect to be in a memory-poor environment for an extended period you might consider 
administratively limiting system load. 

8.6 Accounting 

UNIX optionally records two kinds of accounting information: connect time accounting and process 
resource accounting. The file /iisrladm/wtmp holds connect time information; process this information with 
ac (8). The file lusrladmlacct holds process time data; use sa (8) to look at this information. 

When charging for computing time, use the information provided by these commands. A convenient way 
to do this is to give commands to the clock daemon cron (8) to be executed every day at a specified time. 
Do this by adding lines to lusrlliblcrontab; see cron (8) for details. 

You can also set disk quotas for individual users with the quotaon(8) command. See quotaon(8) and 
edquota (8) for details. 

8.7 Backing Up Your System 

“Backing up” means putting copies of disk files onto magnetic tape for safe storage. Do this periodically 
by the schedule described in Section 8.5. 

The -r option of dump (8) notifies people from the group operator when it needs attention. Add users to 
operator in the file Ictclgroup (see group (5)). root should be a member of operator. 

In a cluster or diskless network only the server node can perform dumps. 

One good method for keeping safe backups on tape is the “Towers of Hanoi” dump sequence. This is a 
series of daily, weekly, and monthly dumps that ensures recent backups for all files. 

Keep these backup tapes as long as you can before reusing them. Table 8-9 shows the Towers of Hanoi 
dump schedule. Table 8-10 shows a sample dump log with this schedule. 
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Table 8-9. Towers of Hanoi Dump Schedule 


Period 

Level 

Explanation 

Daily 

3,2, 5,4, 
7, 6, 9, 8, 
9,9,... 

Each day, run a dump (8) of all file systems. The first day, 
run a “level 3“ dump, the next day a level 2 dump, and so 
forth following the sequence at left. This saves the files 
changed each day. 

Stop the daily sequence when you do a weekly (level 1) dump, 
and restart on the next day at level 3 again. 

Weekly 

1 

Each week, run a level 1 dump of all file systems. This saves 
all files changed since the last level 1 dump. Restart the daily 
sequence at level 3. 

Monthly 

0 

Each month, run a level 0 dump of all file systems. This 
makes a complete copy of every file on the system. 


Table 8-10. Sample Dump Log for Towers of Hanoi Schedule 


Tape Label 

Level 

Date 

Who 

Size 

FULL 

0 

Nov 24, 1986 

cf 

137K 

Daily 1 

3 

Nov 28, 1986 

cf 

29K 

Daily 2 

2 

Nov 29, 1986 

km 

34K 

Daily3 

5 

Nov 30, 1986 

km 

19K 

Daily4 

4 

Dec 1, 1986 

km 

22K 

WEEK1 

1 

Dec 2, 1986 

kh 

40K 

DailyS 

3 

Dec 4, 1986 

km 

15K 

Daily6 

o 

Dec 5, 1986 

cf 

25K 

Daily7 

5 

Dec 6, 1986 

cf 

15K 

DailyS 

4 

Dec 7, 1986 

km 

19K 

WEEK2 

1 

Dec 9, 1986 

kh 

118K 

Dailv9 

3 

Dec 11, 1986 

km 

15K 

Daily 10 

r\ 

Dec 12, 1986 

km 

26K 

Daily 1 

5 

Dec 15, 1986 

km 

14K 

WEEK3 

1 

Dec 17, 1986 

kh 

71K 

Dailv2 

3 

Dec 18, 1986 

kh 

13K 

FULL 

0 

Dec 22, 1986 

kh 

135K 


me Procedure to Dump a file System shows how to run a dump (S). The Procedure to Restore Files From 
a Dump Tape shows how to retrieve files from a dump tape. 
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Procedure to Dump a File System 



ACTION 

WHAT IT DOES 

Step 1. 

Boot down to single-user UNIX 
(the # prompt). See Section 8.3. 

Forces all other users off the system. Running dumps 
while people are modifying the file system can cause 
all sorts of errors. Dumps are safest while in single- 
user mode. 

Step 2. 

Prepare a tape for the dump. Use 
either a blank tape or one with 
unneeded contents. 

Label the tape with today’s date, 
tire level of dump, and the file 
system you are dumping. If the 
dump will take more than one tape, 
number the tapes. 

Prepares the tape for dumping and for archival 
storage. Make sure the label is legible; dump tapes 
do no good if you cannot find the one you need. 

The dump may require more than one tape. If so, the 
dump program will print this information when you 
begin the dump. 

Step 3. 

Load the tape in the tape drive. If 
necessary, use the command 

mt rewind 

to rewind the tape. 

Readies the tape for the dump. 

If the system has more than one tape drive, use the -f 
option for mt(l) and dump (8) to specify another 
tape drive. The default is drive 0. 

For example, to rewind a tape on drive 1, enter 

mt -f /dev/rmt!3 rewind 

Step 4. 

“Retcnsion” the tape with the 
command 

mt reten 

Winds the tape all the way forward and all the way 
back. This smooths out reel tension for the tape, 
lowering the chances of tape failure during the dump. 

If the dump requires more than one tape, retension a, 
of the tapes now. 

Step 5. 

Enter the command 
dump nun Idevlrdcv 
where 

n is the level number of the 
dump. 

dev is the disk partition holding 
the file system for dumping. Do 
not forget the /dev/r before dev. 

Executes the dump, dump will print many messages 
on the console, including notification when the dump 
is complete. 

For example, to dump (at level 0) the lu file system 
on the g partition of a CDC Wren 86 disk on an 
Optimum V system, enter 

dump Oun / dev/rsdOg 

Step 6. 

When he dump is finished, remove 
the tape and store it. 

.Archives the dump for future restores (restore (8); if 


End of 

'procedure 
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Procedure to Restore Files From a Dump Tape 



ACTION 

WHAT IT DOES 

Step 1. 

Load the tape in the tape drive. If 
necessary, use the command 

mt rewind 

to rewind the tape. 

Readies the tape for restoring. 

If the system has more than one tape drive, use the -f 
option for mt(l) and restore (8) to specify another 
tape drive. The default is drive 0. 

For example, to rewind a tape on drive 1, enter 

mt -f /dev/rmtl3 rewind 

Step 2. 

Enter the command 

restore xv filel filc2 ... 

where filc.J filc2 ... is a space- 
separated list of the files you want 
to extract irom the dump tape. 

If you want to restore a complete 
directory' and all files and 
subdirectories under it, enter the 
command 

Extracts the named files or directories from the dump 
tape, restore (8) should print the name of each file as 
it restores it. 

See restore (8) for details on this command. 

Use restore rv with caution, and only under these 
circumstances: 

• Writing to a new file system (created with 
newfs (8) 

• Making incremental restores after a full level 0 


restore xvh directory 

where directory is the pathname of 
tlie directory. 

If you want to restore the entire file 
system, enter the command 

restore rv 

restore 

Step 3. 

After finishing all restore 
commands enter the command 

rm /restoresymtab 

Removes the system file used for incremental restore 
passes. 

Step 4. 

Enter the command 
mt rewind 

Rewinds the tape. 

Step 5. 

Remove the tape and store it. 

Saves the tape for later restores if necessary. 


End of 

procedure 
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APPENDIX A: LOADING UNIX FROM TAPE 


This appendix tells how to install UNIX onto the system from a release tape. 

If you are using a system shipped complete from Integrated Solutions, do not use these procedures. The 
system is fully installed and ready to boot from disk. Turn to "Section 2: Starting UNIX From Disk." 

If you want to install UNIX on a cluster or diskless network use these procedures to install die server node. 
After fully installing die server node turn to "Section 6: Setting Up Cluster Nodes" or "Section 7: Setting 
Up Diskless Nodes." 

This appendix contains the following subsections: 

A.l Why Should You Boot From Tape? 

A.2 Do You Have Everything You Need? 

A.3 Booting the Minirool File System 
A.4 Booting the Complete Root File System 
A.5 What Now? 

A.l Why Should You Boot From Tape? 

“Bootstrapping,” usually abbreviated to “booting,” means loading and executing a system program 
(usually the operating system, UNIX). With UNIX, full operation means that the system has a fully 
installed file system and a working shell (command processor). 

With UNIX installed on disk, the system will be able to “autoboot,” to boot itself without help. Your task 
is to install UNIX on disk so that it can do so. 

Use the procedures in this appendix to install UNIX under these conditions: 

• Installing UNIX on a mesh disk. 

• Some accident, such as a power failure, destroyed data on the disk and UNIX will not boot. 

NOTE 


You can repair most disk damage without re-installing UNIX. See 
Section 2.6 and Appendix B. 
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A.2 Do You Have Everything You Need? 

You should have a fully installed Optimum or Optimum V system, as described in the appropriate 
Installation Manual: 

• All boards plugged into the card cage 

• At least one disk connected 

• A connected tape drive 

• A terminal (or workstation monitor) connected to the console line 

• System plugged into an AC wall outlet 

You should know the revision level of the PROMs on your CPU board. In Step 4 of the Procedure to Load 
and Boot the Miniroot File System, you will need to know if your PROM revision level is above or below 
Revision 4.0. The PROM displays its revision level in a message to the console, (or Workstation monitor) 
during a boot. Look for a line of this form: 

VMEUUSfGSUS) 680 AW prom-levcl boo V.datc 

If you are in doubt, look on the board and read the revision level from a sticker on the PROM. 

Find the name of the system’s boot disk in Table A-l. 

Table A-l. UNIX Disk Names 


Product Name 

Device 

Controller Name 

Optimum V Systems and Workstations 

VDS106 

5 14-inch disks (SD-style) 

sd 

VED106 

1 06 Mbytes formatted 


VDS139 

5 14 -inch disks (embedded SCSI) 

gd 

VED139 

139 Mbytes formattted 


VDS269 

8-inch disks (SMD-style), 

sm 

VED269 

269 Mbytes formatted 


YDS418 

9-inch disks (SMD-style), 

sm 

VED4I8 

418 Mbytes formatted 


VDS494 

8-inch disks (SMD-style), 

sm 

VED494 

494 Mbytes formatted 


; Opdmum Systems 

j DS36 

5 -/--inch disks, 

e! 

i ZD36 

36 Mbytes formatted 


DS67 

5 : /Lir.ch disks. 

el i 

ED57 

67 ypb’.-^s formatted 

i 

i 

DSS5 

5 v- -ir.cn disks. 

el ; 

EDS5 

85 Mbytes formatted 

I 

! 

DS140 | 

5 ‘/--inch disKS, 

el i 

ED14Q i 

1-0 Mbytes formatted 


DS330 

SMD-stvie cisks, 

np 

ED330 

330 Mbytes formatted 


DS-7-: j 

SMD-style disks. 

np 

ED-7- ! 

474 Mbytes formatted 

i 


A-2 


Loading UNIX r-rom Tape 



System Administrator Guide 


SMM:1 


Find the name of the system’s tape drive in Table A-2. 


Table A-2. UNIX Tape Drive Names 


Device 

Name 

Optimum V Systems and Workstations: 


All tape drives (except embedded SCSI) 

is 

Embedded SCSI 


Optimum Systems: 


TS-11 tape drives 

ts 


Enter die PROM revision level, disk name(s), and tape drive namc(s) in "Appendix C: Configuration 
Worksheet." Fill in the rest of Appendix C to the best of your knowledge. This will serve as an easy 
reference in later procedures. 

Have these materials on hand: 

• The appropriate Installation Manual (for example, the Optimum V24 SystcmIWorkStation Installation 
Manual) 

• The UNIX 4.3BSD Reference Set, seven volumes 

• The ISI UNIX Release 4.0 release tapes (two tapes) 

Table A-3 shows the format of the release tapes for Integrated Solutions Release 4.0 of UNIX. 

All release tapes contain the files necessary to boot either an Optimum System or an Optimum V System or 
Workstation. 

The release tapes includes graphics software (files 14 and 15, tape 2, in Table A-3). If you do not have a 
graphics workstation, you do not need this software. The server node for a Cluster or Diskless 
Workstation does need this software. 

The release consists of two 1/4-inch cartridge tapes or two 1/2-inch reel-to-reel tapes. Note that this does 
not include the diagnostic tape, which is a separate tape for diagnostic purposes only. 
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Table A-3. Format of the Release 4.0 Release Tapes 


File 


Description 

1/4-Inch 

Tape 

1/2-Inch 

Tape 

Contents 

(tape 1)0-8 

(tape 1)0-8 

miniroot 

the “miniroot” file system, with install software 

9 

9 

root 

dump (8) of root (/) file system 

10 

10 

kernels 

tar (1) of kernels for the root file system 

11 

11 

bin 

tar of /usrlbin 

12 

12 

ucb 

tar of lusrlucb 

13 

13 

doc 

tar of lusr/doc 

14 

14 

man 

tar of lusr/man 

15 

15 

games 

tar of /usr/ games 

16 

16 

new 

tar of /usr/new 

17 

17 

old 

tar of lusr/old 

(tape 2)0 

(tape 2)0 

sys 

tar of /usr/ sys 

1 

1 

lib 

tar of lusrllib 

2 

2 

etc 

tar of /usr/etc 

3 

3 

diet 

tar of /usr/ diet 

4 

4 

include 

tar of lusr/includc 

5 

5 

bench 

tar of /usr/bcnch 

6 

6 

adm 

tar of lusr/adm 

7 

7 

spool 

tar of /usr/ spool 

8 

8 

guest 

tar of /usr/ guest 

9 

9 

hosts 

tar of hisr/kosts 

10 

10 

local 

tar of lusrilocal 

11 

11 

msgs 

tar of iusrimsgs 

12 

12 

preserve 

tar of lusr/prcserve 

13 

13 

pub 

tar of /usr/pub 

14 

14 

tmp 

tar of /usr limp 

15 

15 

graphl 

tar of graphics files in root file system 

16 

16 

graph2 

tar of graphics files in / usr file system j 

17 

17 

X 

tar of X window system hies : 

18 

18 

UPDATE 

tar of UPDATE script ! 


A.3 Booting the Miniroot File System 


Booling UNIX is a two-stage process: 


Boot UNIX from the ‘'miniroot”, 
rudimentary UNIX and use i: to load ' 

Bool UNIX from the root hie svstem. 


i he miniroot is a subset of the root hie system, 
the full root (/) hie system and /usr hie system. 

Tnis installs the tools for a full boot to UNIX. 


rsooi mis 


Use the following Procedure to Load and Boot the Miniroot File System to start the system, load the 
miniroot from tape, and boot the miniroot. 
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Procedure to Load and Boot the Miniroot File System 



ACTION 

WHAT IT DOES 

Step 1. 

Turn ON power for the terminal 
connected as the system console (or 
the Workstation monitor). 

Prepares the terminal to print boot messages. 

Step 2. 

Turn the system power ON. 

Check that the DC ok indicator 
lights up. 

Provides power to the system. After a short wait, this 
message should appear on the console: 

Integrated Solutions 

VMEBUS^fit/SJ 680XX prom-level boot idale 



The colon (:) is a prompt from die UNIX PROMs 
(sec Section 1.2, "Introduction to Hardware"). 

Step 3. 

Put the first of the two release tapes 
into the tape drive. 

Prepares tire uipe. 

Step 4. 

Enter this command: 
ts@ 

exactly as shown. 

The notation will not work 

with older PROM levels on the 
CPU board. See the information at 
right. 

Begins installation of the miniroot from the release 
tape. For example, on an Optimum V system with a 
VME-68K20 CPU, enter 

ts@ 

This invokes a program called tire Miniroot Installer. 
The console should print 

xxx+xxx+xxx start at O.v.vh’w 

--System-type PROM-level Miniroot Installer — 

PROMs previous to PROM Revision 4.0 will not 
execute the ts@ command. See Section A. 2, "Do 
You Have Everything You Need?" to determine your 
PROM revision. If you have a pre-4.0 PROM, you 
must issue a different command, based on your CPU 
board: 

VME-6SK20: rj(O.O) 

VME-68K10: ts(0,3) 

IS-6SK (Q-bus) ts( 0.2; 


(continued 

on next pace) 
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Procedure to Load and Boot the Miniroot File System (continued) 


ACTION 

WHAT IT DOES 

Step 5. 

Accept the defaults by pressing 
return or answer no to specify 
another partition. 


Step 6. 

Enter the following response to the 
Miniroot Installer’s prompt: 

dev(nyl) 

where 

Copies the miniroot to disk and boots the. miniroot. 
This command copies the miniroot to partition 1, also 
known as partition b, of the chosen disk. Remember 
that partition numbers, like file numbers on the 
release tape, start at 0. 


dev is the name of the disk, from 
Table A-l 

For example, for an Optimum V system with one 
SMD disk, enter 


n is the number of the disk drive 
(0 for the first disk drive, 1 for 
the second disk drive, and so on) 

NOTE 

sm(0,l) 

During a brief wait, you should see and hear the tape 
moving. The system now bools on the miniroot, 
ending with the single-user UNIX prompt (#): 


SMD-lypc (“sm”) disks arc 
numbered 0 for the first one, 
2 for the second SMD-type 
device, 4 for the third 
SMD-type device, and so 
on. 

xxx+xxx+xxx start at Oxnnvw 
Integrated Solutions UNIX Release 4.0 tin 
(root @ system-name) date 
real mem = xxx 
avail mem = yyy 
(information about devices) 



CTC System Clock (or LTC) 



You arc now in UNIX, booted from miniroot. 

Step 7. 

Continue to the next section, and 
execute the UNIX install script. 

Completes the installation of UNIX, as described in 
the next section. 


End of 

procedure 


A. 4 Booting the Complete Root File System 

.After booting from miniroot, the install script is automatically started. 

Table A-- shows the disk types for all disks used with Integrated Solutions VMEbus Systems. Do not 
confuse this with the disk "names" in Table A-l. "RLL encoded" means that the Optimum V systm uses 
Run Length Limit encoding to yield a higher formatted capacity. 
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Use the following Procedure to Boot from the Root File System to install the root (/) and lusr file systems, 
and to reboot from the new root kernel. 


Procedure to Boot from the Root File System 



ACTION 

WHAT IT DOES 

Step 1. 

After completing the previous 

The screen should show a message about the 


procedure, you should now be in 

installation, beginning with the line 


the install script. 

===4.3BSD UNIX INSTALL— 
and concluding with this prompt: 

Do you want to continue with the installation? [y ]: 

Step 2. 

Provide information to the install 

Assists the install script in making the correct 


script prompts. 

installation for your system. The install script 
follows the steps in the remainder of this procedure. 



When the install script is finished, you can reboot the 
system automatically, or exit the script and remain in 
the miniroot shell. Unless you have special 
configuration concerns, you should perform the 
reboot. 

Step 3. 

The install script prints litis prompt: 
Do you want to continue with 

Allows you to immediately exit the install script if 
desired. Press RETURN to continue with the 
installation. 


the installation? [y]: 

Step 4. 

The install script prints this prompt: 
Please enter the disk device 

Prompts for the disk device name for the boot disk. 
UNIX provides a default value from 
autoconfiguraiion information. If this value is 
correct, simply press RETURN. 

If you want to supply another value, from the choices 
in Table A-l, enter the value, and press RETURN. 

name [cfcv.Y]: 

where devN is a default value. 


Step 5. 

Tne install script prints this prompt: 

Prompts for the tape device name of the tape drive. 


Please enter the tape drive 
name [devN]: 

UNIX provides the default value from 
autoconfiguration information. 


where devN is a default value. 


Step 6. 

Tne install script prints this prompt: 

Prompts for setting up spar.disks. Answering “yes” 


Do you want to set up any 
spandisks? [y ]: 

allows you to set up as many as four separate 
spandisks. If you answer “no”, skip to Step i 0. 
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Procedure to Root from the Root File System (continued) 


ACTION 

WHAT IT DOES 

Step 7. 

The install script prints the prompt: 

Which spandisk partition do 
you want to set up? [spOc]: 

Prompts for the first spandisk partition to be created. 
Allowable partitions are spOc, splc, sp2c, and sp3c. 
You may enter any of these partitions or press 
RETURN to accept the default. 


Step S. The install script prints this prompt: 

Available partitions and sizes: 
partition size partition size 
partition size partition size 

Remember that partitions d, e, 
and f make up partitioning so 
they are mutually exclusive on 
any particular disk. 


Prompts for the list of disk partitions to be used in 
creating the designated spandisk. Available 
partitions and their sizes are listed along with the 
prompt. Partition g is actually the combination of 
partitions d, c, and f so you cannot use partition g on 
any disk where partitions d, c, and f are already used. 
To use an entire disk, specify partitions devNa , 
dcvNb, dcvNg. Include partition dcvNh if applicable. 


Please enter all desired 
partitions on a single line... 

where partition is devNparl, dev is 
disk device, N is disk number and 

part is the partition letter. 

Step 9. The install script prints this prompt: 

Which spandisk partition do 
you want to set up? [none]: 

Step 10. The install script prints this prompt: 

Will you be installing the / usr 
file system now? [y]: 


Allows you to set up other spandisks. Press 
RETURN to continue with the installation process. 
Steps 8 and 9 may be repeated for the three 

additional spandisks if desired. 

Prompts for installation of the / usr file system. You 
should answer “yes” (y) if you have a disk partition 
ready for the iusr file system. 

Answer “no” (n) if you must prepare a disk partition 
before installing the iusr file system. 


Step 11 . The install script prints this prompt: 

Do you want to remove the 
kernels and kernel configura- 
tion directories for alternate 
configurations? [yj: 


See the procedure in Step 30 for instructions to use 

the iinstallusr and /install graphics scripts. 

Prompts for removal of possibly extraneous 
directories and kernels. 

The release tapes includes configuration files for ail 
ISI systems. You may only need the condguraiicn 
hies for your own system. If so, answer “yes” (y) to 
this question. 

Servers for diskless or cluster nodes should retain tne 
configuration files, since they may need to provide 
kernels for the individual nodes. 


continued or. next page) 
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Procedure to Boot from the Root File System (continued) 



ACTION 

WHAT IT DOES 

Step 12. 

The install script prints this prompt: 

The default is to install the files. 


Do you want /usr/doc (approx. 
6450 kbytes) installed? [yj: 


Step 13. 

The install script prints this prompt: 

The default is to install the files. 


Do you want /usr/games 
(approx. 2150 kbytes) 

installed? fy): 


Step 14. 

The install script prints this prompt: 

The default is to install the files. 


Do you want /usr/man (approx. 
3300 kbytes) installed? [v]: 


Step 15. 

The install script prints this prompt: 

Do you want the graphics files 
extracted from the tape? [y]: 

Prompts for graphics software extraction. Answering 
“yes” (y) to this question means that the install 
script will install graphics software onto your system. 
All Workstations and servers for graphics cluster or 
diskless nodes should do this. 

Step 16. 

The install script prints this prompt: 

Is the console a graphics 
workstation? [yj: 

This question appears only if you answered “yes” 
(y) to the question above. Answering “yes” (y) to 
this question causes the install script to alter the file 
letclttys to accommodate the workstation monitor. 

Step 17. 

The install script prints this prompt: 

The default is to install the files. 


Do you want to install the X 
windows files? [y]: 


Step 18. 

The install script prints the prompt: 

Usr files are about N kbytes. 
Available disk partitions are: 
partition size 
partition size 

Prompts for placement of the /usr file system. The 
normal placement, the default here, is on the first 
partition of the list of partitions large enough: for the 
files. 


Enter the disk partition to 
install /usr onto [devil par:}: 



< continued 
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Procedure to Boot from the Root File System (continued) 

ACTION WHAT IT DOES 

Step 19. The install script prints the response is the information you entered to earlier 

message: prompts. If you answered no to the installing lusr 

„ x „ ... prompt, the remaining message lines are not printed. 

System configuration is SYS. 1 b 1 

(This is not alterable.) 

Disk Drive name is diskdev. 

Tape drive name is lapcdcv. 

Making spandisks: partition ... 

Installing /usr file system on 

dcvNpari. 

Removing alternate kernels 
and kernel configurations: 

response 

Installing /usr/doc: response 
Installing /usr/games: response 
Installing /usr/man: response 
Installing graphics files: 
response 

Console is graphics worksta- 
tion: response 

Installing X windows: response 

Is this setup correct? [y]: 


Siep 20. 

The install script makes tape 
devices on the miniroot. 

Makes devices required by the remainder of the 
scripts. 

Step 21. 

The install script creates a root 
directory. 

Provides an empty root file system for the contents of 
the release tape. The install script creates the file 
system and checks it with fsck (8). 

Step 22. 

The install script installs the root 
file system. 

Extracts the root file system from the release tape and 
installs it on your system. The install script checks 
the new file system again with fsck (8). 

Step 23. 

The install script creates devices in 
the Idev director) 7 . 

Provides disk and tape devices. For workstations, 
this step also provides the graphics console device. 


(continued 

on next page) 
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Step 24. 


Step 25. 


Step 26. 


Step 27. 


Step 28. 


Step 29. 


Procedure to Root from the Root File System (continued) 
ACTION WHAT IT DOES 


The install script edits the file Configures /eiclfstab for your system. See fstab (5) 

letclfstab to match this configura- for detail on /etc/fstab entries. 

tl0n ‘ If you sec an error message at this point, you should 

edit letclfstab manually after the end of this 

procedure. 

The install script creates a lusr Provides an empty lusr file system for the contents of 

directory. the release tapes. The install script creates the file 

system and checks it with fsck (8). 

The install script installs the lusr Extracts the lusr file system from the release tapes 
file system. and installs it on your system. 

The lusr file system is split across the two release 
tapes. When the script has extracted everything from 
the first tape, it will prompt you to change tapes. 

The install script installs graphics Extracts graphics files from the release tape, 
software, if you requested it in Step 
8 . 


The install script prints this prompt: 

Set root password 
New password: 

Type a new password in response 

to the prompts. 

The install script finishes by- 
rewinding the release tape and 
printing a prompt to reboot the 
system. 


Assigns the root password. Write it down 
somewhere safe. Because the root login account has 
unlimited access to die entire system, you must 
protect that access by assigning a root password and 
by keeping knowledge of the password limited. 


Finishes the installation and prepares for reboot. 

Unless you have special configuration requirements 
that would prevent a reboot, you should now reboot 
the system. Simply press RETURN at the final install 
script prompt. If you need to make a special disk 
configuration for lusr, do it here and run iinstallusr 
and / install graphics. 


(continued or. next pattei 
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Step 30. 


Procedure to Hoot from the Root File System (continued) 
ACTION WHAT IT DOES 


If you did not install the /usr file 
system from tape, you must prepare 
a disk partition now, and extract the 
/usr file system. 


Installs the /usr files system from the release tapes. 

To install the /usr file system, use the Unstallusr 
script: 

1. Create or configure a disk partition for the /usr 
file system. 

2. mount (8) the file system. 

3. Insert the first of the two release tapes into the 
tape drive. 

4. Enter the command 

/installusr 

5. Follow the instructions of the script. The 
instructions are the same as previously 
described in this procedure. 

If you want graphics files as well, use the 
/ install graphics script: 

1. Check that the /usr file system is installed and 
mounted. 


2. Insert the second of the two release tapes into 
the tape drive. 

3. Enter the command 


/installgraphics 

4. Follow the instructions of the script. The 
instructions are the same as previously 

described in this procedure. 

(continued on next page) 
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Procedure to Root from the Root File System (continued) 



ACTION 

WHAT IT DOES 

Step 31. 

After running the install script, 
reboot the system. Enter this 
command at the PROM prompt (:): 

Boots UNIX from the kernel file Ivmunix in the root 
file system. For example, for an Optimum V 
Workstation with a VDS269 disk subsystem, enter 


dev(/i.O)vinunix 

sm(0,0)vmunix 


where 

These messages should appear: 


dev is the name of the disk, from 
Table A-l 

n is the number of the disk 

xxx+xxx+xxx start at Oxwnnv 
Integrated Solutions UNIX Release 4.0 tin 
(nn)t@systcm-name) date 
real mem= (physical memory) 
avail mem= (memory for user files) 

Using xx buffers containing . . . 

(information about devices) 



root on dev 0a, dump on dev Ob, 
args on dev Ob, swap on dev Ob 
CTC System Clock (or LTC) 
ti 



You are now running single-user UNIX off the 
installed root file system. Continue to Section A. 5 to 
finish installing the software. 

End of procedure 
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A.5 What Now? 

Use the following procedure, the Procedure to Clean Up After Installing UNIX, to clean up loose ends 
from the installation procedure in the previous section. 

After booting from the root file system (dev(0,0)vmunix) the console now shows the single-user UNIX 
prompt (#). 


Procedure to Clean Up After Installing UNIX 



ACTION 

WHAT IT DOES 

Stcpl. 

Enter the command 
chmod 755 / /usr 

chmod (1) sets protections and permissions for the 
root (/) and /usr directories. The mode 755 denies 
write permission to everyone but root, but opens the 
directories for reading and searching by anyone. 

Step 2. 

Check that the /dev directory 
contains special files for all of the 
devices attached to the system. 

Checks for proper configuration. 

See Section 4.6, "Making New Devices in /dev," to 
add devices. 

Step 3. 

Turn to "Appendix C: Config- 
uration Worksheet" and write down 
any changes. 

Updates the reference sheet. 

End of procedure 


You have now installed UNIX. Reboot the system with reboot (8) and continue to "Section 3: Setting Up 
Your System." 
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APPENDIX B: USING DIAGNOSTIC PROGRAMS 


Use these diagnostic programs to test the CPU, the memory board, and the disks. 

For more information on repairing disk blocks, see ISI Technical Bulletin 001, “Disk Bad Tracks and 
Blocks.” 

This appendix contains the following subsections: 


B.l 

When to Run Diagnostics 

B.2 

Running the Diagnostics 

B.3 

Using copy 

B.4 

Using mmu 

B.5 

Using mem 

B.6 

Using dma 

B.7 

Using bad 144 

B.8 

Using diskformat 

B.9 

Using gdbad 


B.l When to Run Diagnostics 

Use these diagnostic programs only if you suspect hardware failures. For example, run diagnostics in 
response to these symptoms: 

• System will not boot 

• Disk errors that fsck (S) cannot correct 

• System crashes frequently 


B.2 Running the Diagnostics 


Tne diagnostic tests are on the Integrated Solutions diagnostic release tape, separate from 
UNIX release tape. Thus, you can load them directly from the tape if, for example, you have 
to load UNIX or. the system and you suspect a hardware problem. 


the standard 
been unable 


Always run the diagnostics 
prompt!:). See Section S. 3, 


in “stand-alone” mode, this means that the console displays 
"When Do You Boot Single-User?" to reach the PROM prompt. 


the 


PROM 


To run diagnostics on a cluster or diskless node, you must first install the diagnostic programs on the 
server's UNIX file system. See Section B.2. 2, "Running Diagnostics from UNIX." To run diagnostics on 
a cluster node see Section 6.6, "Booting Single-User on Cluster Nodes." To run diagnostics on a diskless 
node see Section 7.6, "Booting Single-User on Diskless Nodes." The only diagnostic tests appropriate to 
these nodes are mmu and mem. 
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B.2.1 Running Diagnostics From Tape 

Use the Procedure to Run Diagnostic Programs From Tape to load a diagnostic program from the 
diagnostic tape and execute the program. 



Enter this command: 
ls@ 

exactly as shown. 


Select a program from the menu. 
Enter the letter for the program and 
cress RETURN. 


Loads the diagnostic interface from the tape. This 
“Diagnostics Executive” is a menu from which you 
choose the program you need. 

The notation works with CPU boards with 

PROM Revision 4.0 or higher. Sec Section A.2, "Do 
You Have Everything You Need?" to determine your 
PROM revision. 

If the notation docs not work, or you have pre- 
4.0 PROMs, use one of the following commands, 
based on your CPU board: 

• VME-68K20: ts(0,0) 

. VME-6SK10: ts(0,3) 

. IS-68K (Q-bus): ts(0,2) 

The screen should now show a menu of diagnostic 
programs. 

Standalone Diagnostic Main Menu 

— <SYS TYPE> <VERSION> Standalone 
Diagnostics Executive 

a) copy b) bad 144 c) diskformat d) mmu 
e) mem f) ama g) gabad 

Enter letter of desired test [a-g]: 

<CNTL>-D exits to boot prompt from the menu level 
<CNTL>-D exits to the menu from a diagnostic 


Loads the program from tape and begins execution. 


ere cj procedure 
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B.2.2 Running Diagnostics From UNIX 

You can load diagnostic programs from the diagnostic tape to the UNIX file system. The diagnostics can be 
booted from disk rather than tape. Use this method under either of these circumstances: 

• You will run diagnostics on a cluster or diskless node. These nodes cannot load diagnostics from the 
tape drive. 

• You will be running the diagnostics often. 

Use the following Procedure to Install Diagnostics in UNIX to extract diagnostic programs from the 
diagnostic tape and install them in the UNIX file system. Perform this procedure on the server node of a 
cluster or diskless network. 


Procedure to Install Diagnostics in UNIX 



ACTION 

WHAT IT DOES 

Step 1. 

Boot the system to single-user or 
multiuser UNIX. 

Prepares the system for tape transfer. You cannot 
install diagnostic programs in the UNIX file system 
from the PROM prompt. 

Step 2. 

Enter these commands: 

mt rew 
mt fsf 10 

Positions the tape for extraction of the programs. 
The mt fsf command winds the tape past the 
PROM-executable programs at the beginning of the 
tape. 

Step 3. 

Enter the commands: 

cd /usr/stand 
tar xv 

Extracts the diagnostic programs from the tape, 
installing them in the directory /usr/stand. This 
command extracts programs for all ISI products; in 
the next step, you can remove those programs that do 
not apply to your system. 

Step 4. 

Enter the command: 
Is 

Lists the contents of the / usr/stand directory. These 
subdirectories contain the diagnostic programs 
appropriate to different ISI systems, where 


iusr/siaiid!V20 is for the VME-68K20 CPU 


iusr/stand/V] 0 is for the VME-68K10 CPU 
lusr/siandlQlO is for the IS-68K CPU (Q-bus) 
NOTE 

For the server node of a cluster or 
diskless network, you should leave 
these extra directories in place, so 
that other nodes can access the 
diagnostics for their own CPUs. 

At this time, if you choose to do so, you can remove 
the directories that do not apply to your system. Use 
the command 

rm -r dir] dir2 

where dirl and dir2 are the unneeded directories. 

( continued or. next page) 
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Step 5. 


Procedure to Install Diagnostics in UNIX (continued) 

ACTION WHAT IT DOES 


To execute a program in this 
directory, boot to the PROM 
prompt and enter the command 

de\i{),6)stand/SYS/tesl 

where 


Loads a selected program and begins execution. 

To execute these programs from cluster or diskless 
nodes, see Section 6.6, "Booting Single-User on 
Cluster Nodes," and Section 7.6, "Booting Single- 
User on Diskless Nodes." 


dev is the name of the disk drive, 
from Table A-l 

SYS is your system type, one of 
• V20 for the VME-68K20 
. V10 for the VME-68K10 


CAUTION 

Execute diagnostic programs in this 
director)' from the PROM prompt 
only. DO NOT execute these 
programs from single-user nor 
multiuser UNIX. 


• Q10 for the IS-68K (Q-bus) 

test is the name of the diagnostic 
test 


For example, to execute the diskformat program on 
an Optimum V WorkS union with a VME-68K20 
board and a VDS4I8 disk drive, enter 

: sm(0,6)stand/V20/diskformat 


(The is the PROM prompt.) The (0,0) refers to 
the first partition of the first SMD-stylc disk 
(numbered from 0, remember), also known as 

partition a , holding the root (/) file system. 

End of procedure 
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B.3 Using copy 

The standalone copy program is typically used to copy files from tape to disk. Copy prompts for the 
FROM device and the TO device and copies all blocks until EOF is reached. 

After loading this test and beginning execution, the screen displays 

... <s\'S TYPE> <VERSION> Standalone Copy — 

From: <Source Device> 

TO: destination Device> 


B.4 Using mmu 

Test the CPU before testing the memory, as CPU errors may cause random errors in the memory tests, 
mmu is a memory management unit test that tests only Lhe CPU. 

After loading this test and beginning execution, the screen displays 

— <SYS TYPE> <VERSION> Standalone MMU Diagnostics — 

Test Functionality 

a) PTP 

b) TBUF_SYS 

c) TBUF_SYS 

d) ALL 

(Enter letter of functionary) : 


Enter c. mmu now displays 



Enter 1 (only one lap is necessary)- The system will then display 
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Lap 1 

Pattern test - segment register 
Walking test - segment register 
Ping-pong test - segment register 
Uniqueness test - segment register 
Pattern test - page register 
Walking test - page register 
Ping-pong test - page register 
Uniqueness test - page register 


This takes about four minutes. You can return to the stand-alone PROM prompt by pressing x twice. If 
you see errors, please try the test again, record all messages on the screen, and contact your distributor or 
Customer Support at Integrated Solutions. 
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B.5 Using mem 

If mmu shows no errors, run mem to check the memory. When this test has been loaded, the screen 
displays 

— <SYS TYPE> <VERSION> Standalone Memory Diagnostics — 

Test region definition: 

Test all memory (default ’yes : ): 


Answer y, and the system will respond 


Enter number of memory banks in decimal (1 to 2047; 0 for autosizing): 


Entering an incorrect number generates a TRAP ERROR; reboot and restart the program. Select automatic 
sizing; the system will then tell how many banks it found and display 


Found X memory banks 

Verbose? (default no): 

Test as a Byte? (default no): 
Test as a Short? (default yes): 
Test as a Long? (default no): 
Test with parity? (default no): 


Use the default (press RETURN). 


Tests Available 

a) Patterns 

b) Walk 

c) Ping-pong 

d) Exec 

e) Uniqueness 
z) All tests 

Enter letter of desired test (’H’ for Help, ’X’ for region redefinition): 


Enter e for the uniqueness option. It takes about one-and-one-half minutes per lap and should be run for 
three laps. To stop the test, hit the x key once: this returns to the “test all memory” section of the 
program. Another x returns to the PROM prompt (:). Report errors as described above. 

The other options are for lengthy Integrated Solutions testing only; ignore them. 
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B.6 Using dma 

This test generates random length DMA transfers through any memory range desired. 

CAUTION 

This is a data destructive test! It will overwrite data in the specified 
test region. 

When the dma diagnostic has been loaded, the console displays 

— — ... <syS TYPE> <VERSION> Standalone DMA Test — 

device: 

Enter the device name, dcv(m, 0) where dev is the name of the device you want to test and m is the device 
number (starting from 0). 

Block size (default 512 bytes): 

Select the default (press RETURN). 


Number of blocks (default 1000): 

Select the default (enter RETURN). 

1 Start of buffer area (NO DEFAULT): | 

Enter 0x20000(h) for the beginning test area. 

j End of buffer area (NO DEFAULT): J 

Enter the hex vaiue for the high end of memory. For example, enter 0x200000 for 2 Mbytes of total 
memory. The buffer must be at least two times the number of bytes to be read. 



Number of laps (0 means forever; 1 default): 


default (press RETURN). 


Done DMA Test: <reyui:s r:ver.> 
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B.7 Using badl44 

The badl44 program builds a table of disk bad blocks and their replacements for use by the remaining 
stand-alone programs and by UNIX 4.3BSD. 

badl44 implements a software remapping of bad blocks and is independent of the hardware remapping of 
bad tracks implemented on any disk controller. A maximum of 126 bad blocks per logical disk can be 
mapped out by badl44. badl44 is not a disk formatting program; it assumes that the disk has already been 
formatted. 

Unlike the other diagnostic programs, bad!44 is available at the UNIX level as described in bad!44(8). 
The UNIX level version of the program is designed for looking at the bad block table on the disk and not 
remapping bad blocks. Use the stand-alone version, as described here, for that. 

If you arc using a system shipped complete from Integrated Solutions, you should not run bad 144 (or any 
of the other stand-alone programs) now unless you have encountered disk problems. 

After loading bad 144 the console displays 


— <SYS TYPE> <VERSION> Standalone Badl44 Program — 

device: 

Enter the device name, dev(m, 0) where dev is the name of the disk and m is the disk number (starting, from 

0 ). 

bad!44 now prompts with 
Options are 

1) Display current bad block information 

2) Add bad blocks 

3) Do read of disk 

4) Do write/read/ verify of disk 

(this option destroys disk contents) 

5) Clear all bad block information 

(this option may cause bad blocks to ’appear’ on disk) j 

6) Do read/write/read/sector of disk ! 

_ Enter number of desired option or (CR) to stop: j 


Select Option 1 to display the current bad block information. Tnis produces output like 


sn = 16570. cr. = 159. tn = 1. sn = 12 


• sn Physical sector number 

• cn Cylinder number 

• tn Track number 

• sn Sector number within the cylinder/track 

Record this information. 

After formatting a disk, run Option 4. Running Option 4 on a disk that has not been freshly formatted is 
fine with bad!44. but will destroy the data on that disk! Be very careful about using Option 4. Run Option 
3 if you do not want to risk losing data. 
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Once you have decided to run the write/read verify, the dialogue might proceed as follows: 


WARNING: this test destroys disk contents 
Do you want to proceed? (y or n) y 

Starting block (default 1): 

Ending block (default end of disk): 

Number of laps (0 or CR means forever): 6 
begin lap 1 

crunning count of disk blocks> 
end lap 1 

checked blocks 1 through 131630 
0 bad blocks this lap 
0 bad blocks on disk 

begin lap 6 

<running count of disk blocks> 
end lap 6 

checked blocks 1 through 131630 
0 bad blocks this lap 
2 bad blocks on disk 


The lap on which badl44 found the two bad blocks is not shown; in the process of finding bad blocks, 
badl44 produces a multitude of disk error messages, which would be tiresome to reproduce here. 

In this example we have run six laps of bad 144. That is because bad 144 writes six different patterns to the 
disk. Six laps can take a long time on a large disk; depending on the type of disk, bad 144 typically can 
write and verify from 7000 to 14000 blocks per minute. (Speeds can exceed 30000 blocks per minute on 
the read-only test.) Verify the entire disk, unless you have reason to suspect trouble in a ; \rticular area. 

Sometimes it will seem obvious from the number of soft errors on a block that the block is marginal, but 
not quite bad enough for bad 144 to identify. It is possible to force the pro grim to accept this block as bad: 
use Option 2. The program will respond 


Enter bad block number, or (CR) if all have been entered 


u.mer the number of the marginal block, me program will keep asking for more blocks until it receives a 
bare carriage return. 


me final option is primarily useful if you have made an 
information from the disk and allows you to start over. 


;rror in using Option 2; it wipes all the bad block 


CAUTION 


If you have had bad blocks on the disk, have been rur 
then use Option 5 to clear the bad block information 
re-enter the bad block numbers, you will not necessa: 
replacement blocks: the data, therefore, may be garble: 


ring UNiA, ana 
and Option 2 to 
iiv get the same 


B-10 


Using Diagnostic Programs 


B-10 








System Administrator Guide 


SMM:1 


B.8 Using diskformat 

Be sure to use the proper version of diskformat for your system. The diskformat for Optimum systems is 
not the same as the diskformat for Optimum V systems. 

Use this program to 

• reformat your disk 

• display parameter and defect lists 

CAUTION 

Try to correct problems with bad 144 before reformatting your disk. 

Reformatting wipes out all data on the disk. 

If you must reformat, first save users’ files on tape. You can then restore these files after reformatting and 
rebuilding UNIX on the disk. 

Table B-l shows characteristics for EL disks (Optimum systems). Table B-2 shows characteristics for SD 
disks, while Table B-3 shows characteristics for SMD disks. 


Table B-l. Parameters for EL Disk Drives with diskformat 


Disk 

Number of 
Heads 

Number of 
Cylinders 

Formatting 

Constant 

DS140/ED140 

15 

918 

7395 

DS418/ED418 

24 

711 

— 

DS474/ED474 

20 

842 

— 

Fujitsu M2243 

11 

754 

52F1 

CDC Wren 36 

5 

697 

22B8 

CDC Wren 86 

9 

918 

4395 

Maxtor 1065 

7 

918 

3395 

Vertex 170 

7 

987 

3 3D A 

Vertex 185 

7 

1166 

34SD 


Table B-2. Parameters for SD Disk Drives with diskformat 


l 

Disk 

Number of 

Number of 

Formatting 

Heads 

Cylinders 

Constant 

; VDSS5 

9 

918 

4395 

! YDS 106 

9 

91S 

a 3 9.5 

Fujitsu \ 222-3. ELL encoded 

1 i 

75-1 

52F1 

i CDC Wren 36 

5 

697 

22B8 

ELL encoded 

5 

697 

22BS 

' Maxtor 1065 

/ 

9 IS 

3395 

l RLL encoded 

7 

918 

3395 

| Maxtor 1 140 

15 

918 

7395 j 

RLL encoded 

15 ! 

918 

7395 

Vertex 170 

i 

' | 

987 

33DA 

RLL encoded 

7 j 

987 

33DA 

Vertex 185 

" i 

1166 

34 SD 

RLL encoded 

- 1 

/ ! 

1166 

3-SD j 
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Table B-3. Parameters for SMD Disk Drives with diskformat 


SMD-type 

Number of 


Sectors 

Cylinder 


Interleave 

Disk 

Heads 


/Track 

Skew 

BseitU 

EStEl 

Factor 

VDS269 

12 

1332 

33 

0 

16 

16 

1 

VDS418 

24 

711 

48 

0 

16 

16 

1 

VDS494 

12 

1439 

56 

0 

12 

12 

1 

CDC PA1A3 

f 

MEM 

80 

0 

mm 

mm 

1 

CDC 9720 


WBSm 

48 

0 

Hst 

IB 

1 

Fujitsu Eagle 

20 

842 

44 

0 

16 

16 

1 

Fujitsu M23 12 

7 

589 

32 

0 

16 

16 

1 

Fujitsu M2333 

10 

823 

64 

0 

16 

32 

1 

Priam 807 

11 

1552 

32 

0 

16 

16 

1 

NEC 2352 

19 

760 

56 

0 

16 

16 

1 


Use these procedures to reformat disks with diskformat: 

• Procedure to Reformat EL Disks with diskformat 

• Procedure to Reformat SD Disks with diskformat 

• Procedure to Reformat SMD Disks with diskformat 


Procedure to Reformat EL Disks with diskformat 



ACTION 

WHAT IT DOES 

Step 1. 

Shut down the system and turn 
power OFF. 

Turns off the system. See Section 2.~, "Shutting 
Down The System." 

Step 2. 

Remove the RL101 L .sk Controller 
board. Set DIP SW 1 to the ON 
position. Replace the RL101 Disk 
Controller board. 

Enables disk formatting. This hardware switch 
prevents accidental formatting of the disk. 

Step 3. 

Turn ON power to the system, and 
press RESET to get the PROM 
prompt (:). 

Displays the PROM prompt for loading diagnostic 
programs. 


( continued on next page) 
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Procedure to Reformat EL Disks with diskformat (continued) ' 

ACTION WHAT IT DOES 

Step 4. Load Lhe diskformat program. Starts the program. See Section B.2 for ways to load 

diskformat. Check that you are using the 
diskformat version for Optimum systems. 

The console now displays 

— <SYS TYPE> <VERSION> Standalone Diskformat — 


Functions available: 

a) Format Disk 

b) Display Paramater and Defect list 

Enter letter of desired function (’H* for Help): 

Step 6. Enter the letter a and press Selects Option a from the menu, to format the disk. 
RETURN. The console now displays Entering H simply reprints 

the menu. To exit the program press “D (CNTL-D). 

diskformat now prompts for a description of the 
disk. 


Step 7. Enter this information to 
diskformat’s prompts: 

• Controller number (0 or I) 

• Drive number (remember that 
the first disk is 0) 

• Number of heads (sec Table 
B-l) 

• Number of evlinders (see Table 
B-l) 


Describes the disk for diskformat. diskformat now 
displays the estimated lime it will take to complete 
the formatting. It also displays a “formatting 
constant” for your approval: 

formatting constant = ro: OK? 

where xxx is the formatting constant computed by 
diskformat based on the information you just 
entered. 


Step 8 . Check that diskformat’s 
formatting constant matches the 
one in Table B-l for the disk. If it 
does, enter the letter y and press 
RETURN. 


Begins reformatting the disk, diskformat displays 
the current cylinder being formatted. 

When diskformat finishes with the disk, it displays 
the initial menu again. Choose an option, or press ~D 
to quit. 


Step 9. After formatting the disks, turn 
Orr power to the system. Remove 
the RL101 Disk Controller board. 
Set DP SW 1 to the OF? position. 
Reduce the RL101 Disk Controller 


Disables disk formatting. Tnis hardware switch 
prevents accidental reformatting of the disk. 


Step IQ. turn ON power to the system. Brings the system back up with the clean disk(s). 

You can now use the reformatted . ...... . T -v-^- 

it vou reiormattea me disk mat contains me UNIX 

Q1SK ' 

bootstrap code, you must now install UNIX from a 
release tape. See Appendix A. 

Restore user files saved on tape before running 
diskformat. 


End of procedure 
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Procedure to Reformat SD Disks with diskformat 

ACTION WHAT IT DOES 

Step 1 . Shut down the system and turn Turns off the system. See Section 2.4, "Shutting 

power OFF. Down The System." 

Step 2. Remove the VME-SCSI Host Enables disk formatting. This hardware switch 
Adapter board. Set Bit 4 of SW1 to prevents accidental formatting of the disk, 
the ON position. Replace the 

VME-SCSI Host Adapter board. 

Step 3. Turn ON power to the system, and Displays the PROM prompt for loading diagnostic 
press RESET to get the PROM programs. 

prompt (:). 

Step 4. Load the diskformat program. Starts the program. Sec Section B.2 for ways to load 

diskformat. 

The console now displays 

— <SYS TYPE> <VERSION> Standalone Diskformat — 

Select drive type to be formatted: 

a) sd 

b) sm 

c) gd 

d) rf 

NOTE: VME diskformat offers options for gd 
(embedded SCSI disk drives) and rf (ESDI disk 

drives) that are currently unsupported. 

StcpS. Enter the number 1 and press Selects formatting for an SD-type drive. The console 
RETURN. now shows 

Functions available: 

a) Format Disk 

b) Display Parameter and Defect List 

■ Enter letter of desired function ( { H* for help): 

Step 6. Enter the letter a and press Selects Option a from the menu, to format the disk. 
RETURN. Entering H simply reprints the menu. To exit the 

program press 'D (CNTL-D). 

diskformat now prompts for a description of the 

disk. 

f COXtlXu£u OK KCXl 00££ i 
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Procedure to Reformat SD Disks with diskformat ( continued ) 



ACTION 

WHAT IT DOES 

Step 7. 

Enter this information to 

diskformat’s prompts: 

• Drive number (remember that 
the first disk is 0) 

• Number of heads (see Table 
B-2) 

• Number of cylinders (see Table 
B-2) 

Describes the disk for diskformat. diskformat now 
displays the estimated time it will take to complete 
the formatting. It also displays a “formatting 
constant” for your approval: 

formatting constant = xxx OK? 

where xxx is the formatting constant computed by 
diskformat based on the information you just 
entered. 

Step S. 

Check that diskformat’s 

formatting constant matches the 
one in Table B-2 for the disk. If it 
does, enter the letter y and press 
RETURN. 

Begins reformatting the disk, diskformat displays 
the current cylinder being formatted. 

When diskformat finishes with the disk, it displays 
the initial menu again. Choose an opLion, or press *D 
to quit. 

Step 9. 

After formatting the disks, turn 
OFF power to the system. Remove 
• the VME-SCSI Host Adapter 
board. Set Bit 4 of SW1 to the 
OFF position. Replace the VME- 
SCSI Host Adapter board. 

Disables disk formatting. This hardware . switch 
prevents accidental reformatting of the disk. 

Step 10. 

Turn ON power to the system. 
You can now' use the reformatted 
disk. 

Brings the system back up with the clean disk(s). 

If you reformatted the disk that contains the UNIX 
bootstrap code, you must now install UNIX from a 
release tape. See Appendix A. 

Restore user files saved on tape before running 
diskformat. 


End of procedure 
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Procedure to Reformat SMD Disks with diskformat 


ACTION 

WHAT IT DOES 

Step 1. Boot to the PROM prompt (:). 

Displays the PROM prompt for loading diagnostic 
programs. See Section 8.3, "When Do You Boot 
Single-User,” for instructions to move between 
UNIX modes. 

Step 2. Load the diskformat program. 

Starts the program. See Section B.2 for ways to load 
diskformat. 

The console now displays 

... <SYS TYPE> < VERSIONS Standalone Diskformat ™ 

Select drive type to be formatted: 

1) sd 

2) sm 

c) gd 

d) rf 


NOTE: VME diskformat offers options for gd 
(embedded SCSI disk drives) and rf (ESDI disk 
drives) that are currently unsupported. 

Step 3. Enter the number 2 and press 
RETURN. 

Selects formatting for an SMD-type drive. The 
console now displays 

Functions available: 

a) Format Disk 

b) Read UIB 

c) Modify UIB 

Enter letter of desired function (‘IT for help): 

Step 4. Enter the letter a and press 
RETURN. 

Selects Option a from the menu, to format the disk. 
Entering II simply reprints the menu. Entering b 
prints the User Interface Block, containing the 
current disk parameters. To exit the program press 
'D (CNTL-D). 

diskformat now prompts for a description of the 
disk. 

(con 

tinned on next pase) 
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Step 5. 


Procedure to Reformat SMD Disks with diskformat (continued) 
ACTION WHAT IT DOES 


Enter this information to 
diskformat’s prompts: 

• Drive number (remember that 
the first disk is 0) 

• Start head volume 0 (enter 0) 

• Number of heads volume 0 (see 
Table B-3) 

• Start head volume 1 (enter 0) 

• Number of heads volume 1 

(enter 0) ' > 


Describes the disk for diskformat. diskformat now 
displays the estimated time it will take to complete 
the formatting. 

“Volumes” refer to splitting your physical disk into 
two logical disks. If you have not done this, answer 
0 to all questions concerning “volume 1.” 

diskformat displays the current cylinder being 
formatted. 

When diskformat finishes with the disk, it displays 
the initial menu again. Choose an option, or press 
to quit. 


• Number of cylinders (see Table 
B-3) 

• Number of sectors per mack 
(sec Table B-3) 

• Amount of cylinder skew (see 
Table B-3) 


If you reformatted the disk that contains the UNIX 
bootstrap code, you must now' install UNIX from a 
release tape. See Appendix A. 

Restore user files saved on tape before running 
diskformat. 


• Size of gap 1 (see Table B-3) 

• Size of gap 2 (see Table B-3) 

• Sector Interleave Factor (sec 

Table B-3) 

End of procedure 


B.9 Using gdbad 

The gdbad program maps bad tracks to the bad tracks table. It is used for SCSI disks only. After you 
select this diagnostic, you are prompted to enter the controller number, target device number, and logical 
unit number (lun). 
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APPENDIX C: CONFIGURATION WORKSHEET 


Use this worksheet to note your system configuration and any changes you make. 


Item 

Information 

Example 

System name 

enter: hostname: 

central24 

Model 

enter: type of system: 

Optimum V24S 

PROMs 

enter: revision level: 

Revision 4.0 



enter: model: 

VDS106 


#1 

enter: name Tabic A- 1): 

sdO 



enter: tvpc ("Table A -4): 

vdsl06 



enter: kernel driver: 

SDO 

Disks 


enter: model: 

VED106 



enter: name ("Table A- Ik 

sdl 



enter: tvpe (Table A-4): 

vcdl06 



enter: kernel driver: 

SDO 


other 

under Comments 




enter: model: 

Vi" Flashback 


#1 

enter: name Table A-2): 

isO 



enter: kernel driver: 

TSO 

Tape 


enter: model: 

V4" CDC 6250 


no 

enter: name Table A-2): 

tsl 



enter: kernel driver: 

TS1 


other 

under Comments 


! 


enter: model: 

VME-ICP16/X j 

i 

j 

-1 

enter: name Table 4-3): 

cpO j 



enter: number of ports: 

16 



enter: kernel driver: 

CPO 





serial 




ports 


enter: model: 

VME-ICPS/X 


j 

enter: name Table 4-3): 

cpl i 

i 


enter: number of doits: 

s ! 



enter: kernel driver: 

CPI I 


other under Comments 


(continued cr. next pace ) 
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Configuration Worksheet (continued) 


Item 

Information 

KSSS3RDSHHK 



enter: 

model: 

Racal-Vadic 


#1 

enter: 

baud rate: 

1200 



enter: 

port: 

uyda 

Modems 


enter: 

model: 



#2 

enter: 

baud rate: 




enter: 

port: 



other 

under Comments 


Software 

release 

I SI release 4.0 


Released 

on 

(circle) 

disk 1/4" tape 1/2" tape 

Vi" tape 

Installed 

1 

I 

date: 

who: 

(first hoot) 
(your name) 

Ethernet 

(circle) 

none VME-ECX Intcrlan Excclan serial 

VME-ECX 

Networks 

describe: 

List networks connected; give hostname and 
address of your system. For diskless or 
cluster networks list hostnames and 
addresses of all nodes. 

Diskless network: 
central24 89.0.1.96 
wsl 89.0.1.97 

ws2 89.0.1.98 


Comments: 
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APPENDIX D: RELEASE NOTES 


Please insert behind this page any release notes that you 


receive for your system. 
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DOCUMENTATION COMMENTS 


Please lake a minute lo comment on the accuracy and completeness of this manual. Your assistance will help us 
to better identify and respond to specific documentation issues. If necessary, you may attach an additional page 
with comments. Thank you in advance for your cooperation. 

Manual Title: 4.3BSD System Administrator' s Guide Part Number: 490197 Rev. C 


Name: Title: 

Company: Phone: ( ) 

Address: 

City: State: Zip Code: 

1. Please rate this manual for the following: 



Poor 

Fair 

Good 

Excellent 

Clarity 

□ 

□ 

□ 

□ 

Completeness 

□ 

□ 

□ 

□ 

Organization 

□ 

□ 

□ 

□ 

Technical Content/Accuracy 

□ 

□ 

□ 

□ 

Readability 

□ 

□ 

□ 

□ 


Please comment: 



2. Does this manual contain enough examples and figures? 


Yes □ No □ 
Please comment: 



3. Is any information missing from this manual? 


\ es □ No □ 
Please comment: 



4. Is this manual adequate for your purposes? 

Yes □ No □ 

Please comment on how this manual can be improved: 
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